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PREFACE 


The Wang Professional Computer Assembly Language Guide provides an overview of 
the Wang Professional Computer (PC) assembler. In addition, it describes the 
arrangement of memory; the syntax and elements of the source program; and the 
directives you need for writing modules, functions, procedures, macros, 
conditionals, and for formatting the program. The last chapters examine the 
listing file, error messages, and the cross-reference file. 

This manual does not explain how to program in assembly language nor 
does it cover the instruction set. For those who do not know how to program 
in 8086 assembly language, the following books are recommended. 

IAPX 86,88 User's Manual . Santa Clara, CA: Intel Corporation 

Literature Dept., 1981. 

An Introduction to ASM 86 . Santa Clara, CA: Intel Corporation 

Literature Dept., 1981. 

Morse, Stephen, P. The 8086 Primer . Rochelle Park, NJ: Hayden 

Publishing Co., 1980. 

v/Rector, Russell and George, Alexy. The 8086 Book . Berkley, CA: 
Osbourne/McGraw-Hill, 1980. 

The 8086 Family User's Manual . Santa Clara, CA: Intel Corporation, 
1979. 

8086/8087/8088 Macro Assembly Language Reference Manual . Santa Clara, 
CA: Intel Corporation, 1980. 

The following books explain how to use the Wang Professional Computer. 

The Wang Professional Computer Introductory Guide (700-8020) 

The Wang Professional Computer Program Development Guide (700-8018). 

This manual contains twelve chapters and four appendices. Chapter 1 
provides a brief overview of the features of the assembly language and the 
assembler. It also explains how to invoke the assembler. 

Chapter 2 explains how memory is arranged. It names and describes the 
function and purpose of each of the 13 registers and describes how to address 
an element in memory, how to use the segment registers, and how to address 
segments. In addition, it explains the purpose of the flag register and the 
way each flag is used. 



Chapter 3 explains the elements of the source program, naming each of 
the many kinds of statements, identifiers, assembler directives, labels, 
symbols, numbers and their possible notations, strings, constants, 
expressions, and operands that are available to the Wang assembler. Chapter 
names the operands associated with assembly language and describes thei 
functions. 

Chapters 5 through 9 describe the different types of assembler 
directives. Chapter 5 lists the data directives through which you define and 
initialize data. Chapter 6 describes the various assembler directives for 
writing program modules and functions and explains how to use them. Chapter 7 
presents the assembler directives used for macros and repeat blocks. Chapter 
8 contains information about conditional directives and how to use them. 
Chanter 9 discusses the listing directives that help you to format the page of 
your program or to suppress text. 

Chapters 10 through 12 describe the tools that you can use to understand 
and debug your source program. Chapter 10 contains a detailed study of the 
listing file (the assembler file that lists the machine code), the address of 
each element of your program, and the symbols used in the program. Chapter 11 
contains a list of error messages and their meanings. Chapter 12 describes 
the cross-reference listing file, CREF, and explains what it does and how to 
use it. 


There are four appendices: Appendix A gives a listing of ASCII 

character codes; Appendix B gives a functional list of all assembler 
directives; Appendix C is a supplement to Chapter 9 and contains a listing of 
all error messages in numerical rather than in alphabetical order; and 
Appendix D provides a listing of the instruction set, the flags that eachj 
instruction effects, a description of what the instruction does, and example^ 
of the use of each instruction. 
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CHAPTER 1 


1.1 ASSEMBLY LANGUAGE FEATURES 


The Wang Professional Computer (PC) assembly language incorporates many 
features usually found only in larger assemblers: macro assembly, conditional 
assembly, and a variety of assembler directives. 

The PC assembly language produces relocatable object code that you can 
load anywhere in memory, allowing the program to execute in the most efficient 
location. Because the code is relocatable, you can create programs in modules 
that are units you can assemble and test individually. 

Through the assembly language's macro facility, you can use the same 
^>lock of code in many programs, eliminating the need to recode frequently used 
■.nstructions. Each time you need a macro, you insert a call in the program. 
r£he assembler then searches for the macro with that name and expands the code 
into the file. 

You can nest macros, i.e., you can insert a macro within another macro. 
Only the size of memory limits the number of macros that you can nest within 
each other. The macro facility also includes repeat, indefinite repeat, and 
indefinite repeat character directives for repeating the macros. 

The assembly language supports a set of conditional directives that make 
the testing of conditions easier. The conditional directives available to the 
assembly language can test for blank or nonblank arguments, for defined or 
undefined symbols, for equivalence, for first or second assembler passes, or 
for the similarity of two strings. As a result of the test, the program can 
branch, leaving unneeded portions of code unassembled. You can nest 
conditional directives to 255 levels. 

The PC assembler can correct some typographical errors. For example, if 
you enter an operand with no defined type for an instruction that accepts only 
one type of operand, the assembler returns an error message but generates the 
"correct" code. 
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In the following example, the assembler scans the instruction and finds 
two different size elements as the source and the destination. AL is a byte 
of register A, while WORDLBL appears to be an error. From the instruction, 
BL, a byte register, seems to be a word long. The assembler modifies the 
operand to fit the register size, making WORDLBL into a byte. 

MOV AL, WORDLBL 


1# 2 HOW THE ASSEMBLER OPERATES: AN OVERVIEW 


The Wang assembler is a two-pass assembler. Once you submit the source file, 
the assembler reads it twice. During the first pass, the assembler evaluates 
the statements, expands macro call statements, calculates the amount of coda 
the assembler will generate, and builds a symbol table where it assigns values 
to all symbols, variables, labels, and macros. 

During the second pass, the assembler fills in the symbol table and 
emits the relocatable object code into an object file with the default 
extension name .OBJ. The Linker creates the executable file from the object 
file by defining all undefined references and giving a nonrelocatable address 
to all relocatable code. * 


You can assemble the source file without creating an .OBJ file. The 
assembler performs all of the other assembly steps, but does not send the 
object code to the disk. It displays only erroneous source statements on the 
terminal screen. In this way, you can assemble modules quickly, test them, 
and correct errors before putting the object code on the disk. 

Upon command, the assembler creates two other files: a listing file and 
a cross-reference file. The listing file has the default extension .LST. It 
contains a copy of the source program; the offset address of each instruction, 
the machine code translation of each statement in hexadecimal notation, a 
symbol table with the values of all symbols, labels, and variables; and a 
listing of all macros that occur within the program. The assembler lists all 
macros in the symbol table. For more information on the listing file, refer 
to Chapter 10, The Listing File. 

The cross-reference file with its default extension of .CRF contains a 
compact representation of variables, labels, and symbols. When the 
cross-reference program processes the cross-reference file, it converts the 
file into an expanded symbol table that lists all the variables, labels, and 
symbols in alphabetical order. Each element is followed by the source program 
line n umb er in which each symbol is defined, and the line number^* in which 
each symbol is used throughout the entire program. The default extension name 
for the final cross-reference file is .REF. For more information on the 
cross-reference file, refer to Chapter 12, The Cross-Reference File. 

Figure 1-1 shows all of the files produced by the assembler and how they 
relate to one another. 
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Figure 1-1. The Files Produced by the Assembler 


1.3 HOW TO INVOKE THE ASSEMBr.FP 


To invoke the assembler, perform the following procedure. 

1. Write the source file using the PC Editor. 

2. Select either the DOS Command Processor or Other from the Main 
System Menu. If you have previously created an assembly language 
menu selection on the Program Development Menu, you can invoke the 
assembler after selecting the Program Development Menu. 
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1.3.1 Calling the Assembler through the DOS Command Processor 


From the System Menu, select the option, DOS Command Processor. Once the 
system prompt appears, you can invoke the assembler. Enter the command MASM. 
This causes the processor to load the assembler into memory. After you enter 
MASM, you can enter all the file names on the same line and then press the 
RETURN key (Method One), or you can press the RETURN key immediately, wait for 
a series of prompts to appear, and respond to them one by one (Method Two). 

Method One 

If you choose to write the file names on the same line and then press the 
RETURN key, the syntax is as follows. 

MASM source file, object file, listing file, cross-reference file 

Upon this command, the assembler assembles your source program and creates an 
object, listing, and cross-reference file. In the following example, the 
assembler assembles a source file, an object file, a listing file, and a 
cross-reference file, all named PR0G1. 

MASM PR0G1, PR0G1, PR0G1, PR0G1 

Default Extension Names 


Each file has a default extension name. If you do not supply your own 
extension, the assembler uses the default name. The default file names are as 
follows. 


File Name 

Default Extension 

SOURCE 

.ASM 

OBJECT 

.OBJ 

LIST 

.LST 

CROSS-REFERENCE 

.CRF 
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Switches 


There are three switches that control some additional assembly features. They 
are as follows. 


/D 

Produces a source listing on both assembler passes. To activate 
this switch, you must create a source listing file. 


Outputs the listing file in octal radix. 


Suppresses the listing of conditionals whose values are false. 

Does not affect any code controlled by the .SFCOND or .LFCOND 
directives. (For more information, refer to Section 9.3.2, The 
.SFCOND, .LFCOND, and .TFCOND Directives.) 


If you wish to use one or more switches with the list of file names, 
enter the switch's name either after the appropriate file or at the end of the 
list of file names, separating each switch's name with a slash. In the 
following example, the switches follow the appropriate file; in the second 
example, the switches are at the end of the file listing. 

MASM PR0G1, PR0G1, PR0G1/D/X, PR0G1 

MASM PR0G1, PR0G1, PR0G1, PR0G1/D/X 

ethod Two 

A second way of invoking the assembler is to enter the command MASM, 
immediately followed by a carriage return. The processor loads the assembler 
into memory. The assembler returns four prompts, one at a time. You answer 
each prompt with the name of the file you wish to create, using up to three 
switches and a carriage return. If you want to use a switch, you must enter 
the file name. You cannot enter only a switch as a response to a prompt. For 
example, as the response for the list file, you can enter: 

PR0G1.LST/D/O 

If you are creating a file called PR0G1, the following prompts appear 
after you write MASM. 

Prompt 1 Source filename [.ASM]: 

You can respond to this prompt by entering: 

• The file name alone, causing the file to use the 
specified name and the default extension .ASM, or 

• The file name and an extension, if the extension is 
different from the default. 
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Prompt 2 Object filename [PR0G1.0BJ]: 

You can respond to this prompt by: 

• Pressing RETURN, so that the file has the same file name as 
the source program with the default extension .OBJ; 

• Entering the file name alone, so that the file has the 
specified name and the extension .OBJ; or 

• Entering the file name and an extension, so that the object 
file has the specified file name and extension. 

Prompt 3 Source listing [NUL.LST]: 

You can respond to this prompt by: 

• Pressing RETURN, so that the assembler creates no listing 
file; 

• Entering a file name alone, so that the listing file has the 
specified file name with the default extension .LST; or 

• Entering a file name and an extension name which create a 
listing file with the specified name and extension. 

Prompt 4 Cross reference [NUL.CRF]: 

You can respond to this prompt by: 

• Pressing RETURN, so that the assembler does not create a 
cross-reference file; 

• Entering a file name alone, which creates a file of the 
specified name and the default extension .CRF; or 

• Entering a file name and an extension name, which create a 
file of the specified name and extension. 

The "Other" Option 

You can invoke the assembler through the "Other” option of the Main System 
Menu. Once you choose Other and press the EXECUTE key, the following prompt 
appears. 

Pile spec:_ _ 

On the line, enter: 

MASM.EXE 
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The following prompt appears: 

Source file [.ASM]: 

Respond to this prompt as you did to those described for Method Two. 
1*3.2 Creating an Assembly Language Menu Selection 


You can create your own assembly language menu selection on the Program 
Development Menu. In this way, you can call upon assembly language through 
the use of menus alone. y 

To create this selection, follow the instructions in The Wang 
Professional Computer Introductory Guide , 700-8020. 

The procedure is as follows. 

1. Select System Utilities from the Main System Menu. 

2. Select Modify System Menus from the System Utilities Menu. The 
Interactive Menu Design Package screen (Figure 1-2) appears. 


Wang Professional Computer 
Interactiue Menu Design Package 
Release 


Select desired option 

- Create new menu 
■ Edit existing menu 


Menu File Id: 

On Oriue: » 


EXECUTE-Proceed 
CANCEL -Terminate 
HELP -Instructions 


Figure 1-2. The Interactive Menu Design Package Screen 
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3. From the Interactive Menu Design Package screen, select the Edit 
existing menu option. When you press RETURN, the cursor positions 
itself on the blank space next to Menu File Id. Because you are 
editing the Program Development Menu, enter: 

PRGDVMEN.DAT 

If your operating system diskette is in Drive A, as an example, type in A, as 
shown. 


On Drive: A 

Once you have entered "assembly language" as a new menu item, answer the 
following prompts as shown. 

• File Id of module to invoke _ MASM.EXE _ 

• On drive _ B (if you put the assembler in Drive B only) 

• Module type: 

^program 

After you have responded to the prompts, exit from the Design Package 
and select Assembly Language. The following prompt appears. 

Source file [.ASM] 

Respond to this prompt as you did to those described for Method Two. 


1.3.3 Control Characters 


You can replace file names with three other responses: a carriage return, a 
corana, or a semicolon. The effect of each response is as follows. 


Carriage return 

causes the assembler to accept the default name 
for that file only. 

Semicolon 

causes the assembler to accept the default file 
names for all of the remaining files. 

Comma 

causes the assembler to accept the default for 
that particular file for Method One only (in which 
you list all four file names after the MASM 
command). 
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accepts the default name for the file. In the following 
example, PR0G1.0BJ becomes the name of your file when you press RETURN. 

Object filename [PR0G1.0BJ]: (RETURN) 

The Semicolon 

Use a single semicolon followed by a carriage return at any time after the 
source file prompt to select the default responses for all of the remaining 
prompts. After using the semicolon, there are no more prompts. Therefore, if 
you want to skip over one prompt only, use the carriage return. 

In the following example, once you enter the semicolon to respond to the 
object file prompt, no further prompts appear. The assembler assembles the 
source and object files. The defaults for the list and cross-reference files 
are NUL files. Therefore, the assembler creates no list or cross-reference 
file. 



Source filename [.ASM]: PR0G1] 

Object filename [PR0G1.0BJ] ; (RETURN) 

The Comma 




se the comma with Method One only. The comma causes the assembler to accept 
pie default name for that file only. In the following example, the assembler 
reates PR0G1.ASM> PR0G1.0BJ, PR0G1.LST, and PR0G1.CRF. 


MASM PR0G1. ASM,, PR0G1, PR0G1 


There are two other controls that help you in the creation of your 
assembly language program. Each causes you to exit from the mode that you are 
in and to return to the system prompt. They are: 


CONTROL + C 

Returns you to command level. If you are in the 
assembly program, CONTROL and C causes assembly to 
stop. Once back at command level, you can invoke the 
assembler again. 

SHIFT + CANCEL 

Returns you to command level. 
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1.4 CREATING AN EXECUTABLE FILE 


After you have entered the last file name, the assembler begins to assemble 
your program. When it is finished, a list of warning errors and severe errors 
appears on the screen. You can go back into editing mode to correct the 
errors. 

If no error messages appear, the assembler has assembled your program 
successfully. You must link your program before you can run it. To call upon 
the Linker, ^return to the system prompt and enter the word LINK, followed by 
your file name and RETURN. 


B: LINK PR0G1 

The linker responds with a series of prompts. 


Run File [PR0G1.EXE]: 
List File [NUL.MAP]: 
Libraries [ .LIB]: 


Answer these prompts by supplying the name of your program. 


Run File [PR0G1.EXE]: PR0G1 
List File [NUL.MAP]: PR0G1 
Libraries [ .LIB]: PR0G1 


For more information concerning the Linker and its utilities, refer to 
The Wano Professional Computer Progr am Development Guide, 700-8018. 

When the Linker is finished, it sends out a series of error messages. 

To run your program, you must correct the problems in the Wang PC Editor. Then 
you can reassemble and relink your program. 


To run your program, write its name after the system prompt. If you 
called your program PR0G1, you would enter it after the system prompt and 
press RETURN as follows. 


B:PR0G1 
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CHAPTER 2 

THE ARRANGEMENT OF MEMORY 


2.1 SEGMENTS AND BASE ADDRESSES 

The processor in the Wang Professional Computer is designed to address up to 
1 megabyte of memory {1,048,576 bytes). A pair of addresses is required to 
address memory: a base and an offset. Through the use of these addresses, 
the PC can access up to 256K (4*64K) of memory at any one time. By changing 
the base values, you can access the full megabyte of memory. " 

A segment is composed of up to 64k bytes of continuous memory. The 
assembler assigns a base address to each segment. Segments can be adjacent, 
apart, partially overlapped, or fully overlapped. 

The base address is a 20-bit number. The high 16 bits of the base 
address are stored in segment registers. The low nibble (four bits) of the 
Address is zero. The processor shifts the 16-bit address in the segment 
Register four binary positions to the left to obtain the 20-bit address. For 
example, if CS contains 4321H, CS points to the segment with the base location 
43210H. Because the low nibble is zero in hexadecimal notation, the address 
of a segment is always divisible by 16 (just as a number that ends in zero is 
always divisible by 10 in decimal notation). 

A physical segment is made up of one or more logical segments. The 
logical segments are related to the physical segments. The processor can 
access up to four segments at a time. Each logical segment is addressed from 
a base address. Each begins with a SEGMENT statement and ends with an ENDS 
statement. Each segment is associated with a segment register that bears the 
same name as the segment and stores the base address of the segment. The 
segment registers are called: 

• Code segment (CS) register 

• Data segment (DS) register 

• Stack segment (SS) register 

• Extra segment (ES) register 
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2.2 REGISTER STRUCTURE 


The registers are readily accessible to the CPU during execution. When you 
use registers efficiently, you save computer time. In the Wang PC, there are 
13 registers: 

• the instruction pointer (IP) 

• four general purpose registers: AX, BX, CX, DX 

• two pointers: the stack pointer (SP) and the base pointer (BP) 

• two index registers: source index (SI) and destination index (DI) 

• four segment registers: code segment (CS), data segment (DS), stack 
segment (SS), and extra segment (ES) 


2.2.1 Instruction Pointer 


All instruction fetches come from the current code segment. The IP register 
contains the offset from the base of the current code segment of the next 
instruction to be executed. However, you cannot access the IP through any 
instruction. Its presence is invisible to the programmer. 


2.2.2 General Purpose Registers 


The general purpose registers are intermediate storage locations for 
constants, variables, and data. The general purpose registers make these 
elements more immediately accessible to the processor. 

You can access the general purpose registers in either words or bytes. 
When you call up the whole word, one of the following registers is called: 

AX, BX, CX, and DX. M X" in this context refers to a 16-bit value. 

8-bit registers are useful for manipulating one byte values. The low 
bytes, containing the 8 least significant bits of AX, BX, CX, and DX, 
respectively, are called AL, BL, CL, and DL. The high byte registers, which 
contain the most significant bits, are called AH, BH, CH, and DH. Figure 2-1 
illustrates the words and bytes in the general purpose registers. 
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Word 

High 

Low 




AH 

AL 

AX 

BH 

BL 

BX 

CH 

CL 

cx 

DH 

DL 

DX 


Figure 2-1. The General Purpose Registers 


2.2.3 Pointer and Index Registers 


The pointer and index registers are four 16-bit registers that can participate 
in most of the same arithmetic and logical operations as the general 
registers. Generally, however, these registers contain offset addresses for 
addressing within a segment. For this reason, you use them within a segment 
for indirect addressing. While you use the stack pointer (SP) implicitly for 
stack operations, you use the source index (SI) and the destination index 
(DI) registers for string operations. 


2.2.4 Segment Registers 


There are four segment registers, each of which holds the start address of the 
segment of the same name. This address is called the base address. They are 
not available for any arithmetic or logical operation. 


2.3 ADDRESSING MODES 


When you write the source program, you should know the different ways to store 
data in memory and how to access it. The manner in which you store and access 
data is called the addressing mode. There are five addressing modes in the 
Wang PC assembly language. 


2.3.1 Direct Offset Addressing 


The offset of the addresses is within the elements themselves. For example: 
MOV AX, BX; load BX into AX 

MOV AX, W0RD1; copies the contents of variable W0RD1 into AX 
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.3.2 Indirect Addressing 


Z: t address of the address to be accessed is stored in the register. For 
e inple: 

MOV AX, [BX]; load the word whose address is in BX into AX. 


2.3.3 Register Offset Addressing 

The address uses a value in memory plus an offset. For example: 

MOV AX, [BP+2]; add 2 to the address contained in the base pointer and 
move the contents of the new address into AX. 

2.3.4 Addressing through Base and Index Registers 


The sum of a base register and an index register form an offset. When this 
offset is added to the appropriate segment register, the address is formed. 
With BX, the default segment is DS; with BP, it is SS. For example: 

MOV AX, [BX][SI] 

MOV AX, [BX][DI] 

MOV AX, [BP][SI] 

MOV AX, [BP][DI] 

In each of the preceding commands, the base register is added to the index 
register, and the value is placed in AX. All of the allowable combinations of 
index and base registers are indicated here. You cannot use any other 
combination. 


2.3.5 Addressing through Base and Index Registers Plus an Offset 


The offset and the two registers are added together to form the offset 
address. This address is added to the segment address to form the program 
address of the element. For example: 

MOV AX, VAR_1 [BX][SI] 

MOV AX, VAR_1 [BX][DI] 

MOV AX, [BX][SI+10] 

MOV AX, VAR_1 [BP][DI] 

The contents of the two registers plus the contents of the variable are added 
together and then moved to AX. 
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2.4 


PORT ADDRESSING 


Using the OUT instruction, you can use two different addressing modes to 
access ports located in the I/O space: direct port addressing and indirect 
port addressing. Direct port addressing through its 8-bit immediate operand 
allows access to ports 0-255. Indirect port addressing uses a 16-bit number 
stored in the DX register. Through indirect port addressing, you can access 
any port from 0 to 65,535. 


2.5 FLAGS 


In addition to the registers, the Wang PC central processor uses six 1-bit 
status flags and three 1-bit control flags. The status flags reflect the 
outcome of mathematical operations. They are set to 1 to reflect one 
condition and cleared to 0 to reflect the opposite condition. 


Carry flag (CF) 

Set if the operation results in a carry 
out of (from addition) or a borrow into 
(from subtraction) the high-order bit 
of the result. 

Auxiliary carry flag (AF) 

Set if the operation results in a carry 
out (from addition) or a borrow into 
(from subtraction) the low-order four 
bits of the result. 

Overflow flag (OF) 

Set if there has been an overflow, that 
is, a significant digit has been lost 
because the size of the result exceeded 
the capacity of its destination. 

Zero flag (ZF) 

Set if the result of the operation is 
zero. 

Sign flag (SF) 

Set if the operation generates a 
negative result. 

Parity flag (PF) 

Set if there was an even number of 

1-bits, e.g., 3 is odd with an even 
parity, while 8 is even with an odd 
parity. This flag checks data 
transmission errors. 


) 
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, e three control flags can alter processor operations, depending upon whether 
ey are set or clear. The flags are as follows. 


Direction flag (DF) 

The flag controls the direction of 
string operation instructions. The 
clearing of the direction flag causes 
the strings to process from low to high 
bits (to auto-increment). Setting the 
bit causes strings to process from high 
to low order bits (to auto-decrement). 

Interrupt-enable flag (IF) 

When set, the flag enables external 
interrupts; when cleared, the flag 
disables them. IF has no affect on 
nonmaskable interrupts. 

Trap flag (TF) 

If the trap flag is set, the processor 
goes into single-step mode for 
debugging. An internal interrupt is 
generated after each instruction so 
that you can study one instruction at a 
time. 


Figure 2-2 shows the use of the control and status flags. 


Control 

Flags 


Status 

Flags 


TF 

TRAP 

DF 

DIRECTION 

IF 

INTERRUPT-ENABLE 

OF 

OVERFLOW 

SF 

SIGN 

SF 

zero _______ 

AF 

AUXILIARY CARRY 

PF 

PARITY 

CF 

CARRY 


Figure 2-2. Flags 
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CHAPTER 3 

THE SOURCE PROGRAM 


The source program is the program that you create. It is composed of mnemonic 
instructions, operands, directives, and symbolic names stored as ASCII text 
files. The assembler translates your source program into an object program 
composed of binary code, the only code the computer can read. 


3.1 LEGAL CHARACTERS AND NAMES 


The legal characters in the Wang PC assembly language are: 

• A-Z 

• a-z 

• 0-9 

• special characters ? . @ _ $ 

In addition to the general special characters that you can use in any 
name, the following group of special characters serve the following purposes 


Special Character 

Function 

Colon : 

an operator to override the original 
segment for one operation only. 

Period . 

operator for field, record, or 
structure name. The separator 
between a structure name and a field 
name. 

Square brackets [ ] 

in register and memory addressing, 
indicates the value in the register 
is an address, not data. 

Parentheses ( ) 

used in DUP expression and to change 
precedence of evaluation of operators 
(as in mathematical expressions). 

Angle brackets < > 

operator in initialization of values 
in records, structures, around 
parameters, in IRP macro blocks; 
indicates literals. 
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Special Character 

Function A 

Dollar sign $ 

symbolizes the location counter that ^ 
keeps track of the current offset in 
the segment being assembled. 

Comma , 

delimits the individual fields in an 
instruction so that the assembler 
recognizes them as separate fields. 

Single and double quotations 

<• ’> r M > 

delimits strings of text so that the 
assembler interprets everything 
within the quotations as being 
literal. 

semicolon ; 

symbolizes that you accept all 
remaining default files in Method One 
of invoking the assembler. 


You can use names to represent code, data, and constants. A numeral 
between 0 and 9 cannot appear as the first character of a name, but must 
r-ppear as the first character of a numeric value. If you use a period in a 
ame, it must be the first character. You can use as many letters as you wish 
xor a name within the confines of memory, but the assembler reads only the 
first 31 letters. 


3.2 FORMAT OF THE SOURCE PROGRAM 


The source program can begin with an optional program name and ends with a 
program END statement. The following program outline shows the optional NAME 
directive and the beginning of the main module accompanied by its final END 
statement. 


NAME PR0G2 


START: 


MOV AX, ABC 


END 

The source program consists of one or more segment blocks that begin 
with a SEGMENT statement and a segment name and end with an ENDS statement. A 
segment is a block of code addressed through one segment register and is 64K 
or fewer bytes long. The segment blocks can appear in any order in your 
source file. The SEGMENT-ENDS directive tells the assembler in which segment 
register it can find the base address for each symbol or line of code. The 
syntax of the SEGMENT-ENDS directive is as follows. 
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segment name SEGMENT [align] [combine] ['class'] 


segment name ENDS 

At runtime, all instructions that generate code and data are in separate 
segments. Your program can be a segment, psit of a segment, several segments, 
parts of several segments, or a combination of these elements. Without a 
SEGMENT statement, your program generates an "invalid object" error at link 
time. 


The segment name is a unique, legal name. The align type can be PARA, 
BYTE, WORD, or PAGE. (Refer to Chapter 6 for definitions of align type, 
combine type, and class name.) The combine type can be PUBLIC, COMMON AT 
expression, STACK, MEMORY, or blank (which defaults to Not Combinable/also 
called Private). 

The Linker uses class name to load segments together. It loads all 
segments belonging to the first class that it encounters together, and then 
all the segments belonging to the next class, and so on, until all of the 
segments have been loaded. 

You can nest segments. Either of the following two arrangements is 

legal. 


A SEGMENT 


A SEGMENT 

B SEGMENT 


A ENDS 

• 


B SEGMENT 

B ENDS 


• 

• 


B ENDS 

• 


A SEGMENT 

A ENDS 


A ENDS 


The following nesting pattern is illegal. 


A SEGMENT 

B SEGMENT 

A ENDS 
B ENDS 
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The following example consists of a data segment that defines two 
variables, each a word long and initialized to 0. 

FIRST_DATA SEGMENT 

VAR1 DW 0 
VAR2 DW 0 

FIRST_DATA ENDS 

The source program begins with an optional NAME directive, followed by 
an optional ASSUME statement that gives the base segment address to symbols. 

If the ASSUME statement is not present, you must attach a segment prefix to 
each symbol every time it is used. For more information concerning the ASSUME 
statement, refer to Section 5.1, The Assume Statement. 

Following the ASSUME statement are one or more SEGMENT-ENDS statements. 
The main module begins with a SEGMENT statement. Each module ends with an 
ENDS statement. The source file ends with an END statement followed by an 
optional label that gives the start address of the main module. 

NAME PROG1 

ASSUME DS: VAR1, CS:VAR2 

SEG1 SEGMENT 

statement 


SEG1 ENDS 


MAIN_SEG SEGMENT 

START: segment 


MAIN_SEG ENDS 
END 
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3.3 STATEMENT LINE FORMAT 


Assembler language directive statements consist of four fields: name, action, 
expression, and comment. The format is as follows. 


Name 

Action 

Expression 

;Comment 


VAR1 

DB 

0D5EH 

;this is 

a comment 

VAR2 

DW 

10,20 

;this is 

another comment 


Instruction statements usually consist of three fields: action, 
express, and comment. The format is as follows. 

Label Action Expression ;Comment 

PARS1 MOV CX,VAR1 ;this is a comment 

ADD AX, BX ;copy the contents of register BX into 

;register AX 


3.4 TYPES OF SOURCE PROGRAM STATEMENTS 


A source program is composed of two types of statements: action and assembler 
^irectives. The name field, when present, is the first entry on the statement 
mine. The name can begin in any column, although normally names begin in 
■>lumn one. The action statement names the operation to be executed. If the 
Tiame field is blank, the action field is the first entry in the statement 
format. It can appear in Column 1 and run to the end of the line. The 
following are examples of action statements. 

INC BH ;add one to register BH 

MOV AX, BX ;move the contents of register BX to register AX 

Assembler directives give instructions to the assembler for input and 
output, format control, memory organization, conditional assembly, listing and 
cross-reference control, and definitions. Unlike instruction statements, 
assembler directives do not generate machine instructions in the assembled 
code. 


In the following examples, the first assembler directive names the 
program, the second names the segment, and the third assigns a value to a 
symbol. 


NAME PR0G_2 
CODE SEGMENT 
VARl EQU 2 


Appendix B lists all assembly directives available in the Wang PC 
assembly language. 
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3.5 ELEMENTS OF THE COMMAND STATEMENT 

Zou should write the command line so that it is comprehensible. Although you 
^an write command lines in a free-form style, they are easier to read if you 
yrite them in a column format. The format of the command statement is as 
follows. 

LABEL: MNEMONIC argument,...,argument ;comment 

The conmand line is composed of many different elements: variables, 
.abels, constants, numbers, comments, and expressions that are composed of 
.perands and operators, strings, and symbols. 


3.5.1 Identifiers 


4n identifier is a symbolic name that represents variables, labels and 
constants. The identifier is composed of up to 31 letters, numbers, and 
underscore characters. Although you can use more than 31 characters when 
naming an identifier, the assembler disregards all characters after 31. 


3.5.2 Variables 


A variable is an element of data with a symbolic name. A variable has three 
attributes: type, segment, and offset. By placing your variables at the 
beginning of your code, you allow the assembler to recognize their attributes 
before they are used in code. In this way, the assembler generates shorter 
instructions. 

Tyb* 

The type of a variable refers to its size. It can either be a byte (DB), a 
word <DW), a double word (DD), eight bytes <DQ), or ten bytes <DT), or a 
structure. 

Segment 

The segment attribute refers to the segment in which you define the variable 
and, consequently, to the base address of the variable: the data segment, the 
code segment, the stack segment, or the extra segment. Through the ASSUME 
directive or a segment override operator, the assembler couples the variable 
name with the segment name. 
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Offset 


he offset attribute is a 16-bit 
(in bytes) from the start of the 
where it is used. The following 
variables are defined. 


unsigned value that refers to the distance 
segment in which the variable is defined to 
example illustrates the attributes with which 


DATA SEGMENT 
WORDVAR DW 
BEGIN DB 5 


The segment attribute for the variable BEGIN is data, the type attribute is 
byte (DB), and the offset attribute is two since two bytes were defined before 
it in the segment. 


3.5.3 Labels 


Labels, like variables, have three attributes: segment, offset, and type. 

The segment attribute is the paragraph number of the beginning of the segment 
in which the label is defined. Labels are always assumed to be in a CS 
register. 



The offset of a label is defined the same way as the offset of a 
.variable. (Refer to Subsection 3.5.2.) The type attribute indicates whether 
(he label is NEAR or FAR. NEAR labels can be referenced only within the same 
egment or group in which they are defined, while FAR labels can be referenced 
from the same or other segments. NEAR identifies a pointer length of 2 bytes; 
FAR identifies a pointer length of 4 bytes. 


3.5.4 Numbers and Their Notation 


Numbers, except numbers including decimals, must be 
of whether they are hexadecimal, binary, or octal. 


5trate how 

to 

write numbers. 

0101011B 

z: 

Binary 

735Q 

= 

Octal 

7350 

= 

Octal 

951 

= 

Decimal 

951D 

= 

Decimal 

OFFH 

= 

Hexadecimal 

25.23E-7 

= 

Real: floating point 

8217R 

= 

Real 


written with an indication 
The following examples 



To avoid confusion, begin with a number rather than with a letter when using 
hexadecimal notation. A leading zero as in OFFH tells the assembler that the 
characters form a hexidecimal number and not a word. 
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.5.5 Strings 


-rings are characters enclosed in delimiters, usually single quotation 
•rks. The following are examples of strings. 

'a string' 

*goodbye' 


.5.6 Constants 


?re are two types of constants available in the Wang PC assembly language: 
.aoie number constants and string constants. Unlike variables, constants have 
ixed values. 

A whole number constant is a nonfractional number between zero and 
:5,535. A string constant is composed of one or two letters enclosed in 
apostrophes. String constants are valued the same as their ASCII 
equivalents. For example, 'A' is 41H, the ASCII code for A. 


5.7 Comments 


The comment begins with a semicolon and can run to the end of the line on 
which it begins. To expand the comment to another line, another initial 
semicolon is required. The comment usually documents and explains programs. 
In the assembly process, the assembler ignores the comment field. 

The comment line is written as follows. 

MOV AX, BX ;This instruction copies the contents of BX to AX. 

;This is a comment line 

Another way of entering a comment is through the COMMENT directive. 

This directive permits you to use multiple lines without using the semicolon. 
The syntax of the COMMENT directive is: 

COMMENT * comment * 

You surround the comment with delimiters, any non-blank character, on each 
Side. The assembler interprets everything inside the delimiters as a 
comment. In the following example, the comment line is on two lines: 

COMMENT 'This is a very, 
very long comment.' 
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**•5.8 Expressions 


An expression is the.value upon which an instruction or directive performs its 
functions. Every expression consists of at least one or more operands. 
Operators join multiple operands, resulting in what looks like a mathematical 
expression. The following are examples of expressions. 

MOV AX, AGAIN*2 

ADD BX, REAL*(ALEX-BETA) 

A EQU (MASK B) XOR (10 and MASK Bl) 


3.5.9 Assembler Directives 


Assembler directives give instructions to the assembler for input and output, 
format control, memory organization, conditional assembly, listing and 
cross-reference control, and definitions. Assembler directive do not generate 
machine instructions in the assembled code. 

The first of the following assembler directives names the program; the 
second names the segment; and the third gives value to a variable: 

NAME PR0G2 
CODE SEGMENT 
VAR1 EQU 2 


3.5.10 Operands 


Operands are the values that follow the instruction. The instruction directs 
the processor to act upon the operand in some way. 

Operands can be constants, data items, symbols, registers, labels, 
variables, structures, or offsets. You can index them through the base or 
index registers or with constants. In a single operand operation, the 
instruction indicates what the processor should do to the operand. In the 
following instruction, for example, the processor adds one to the index 
register. 

INC DI 

In a double operand operation, one using two operands, the operand to 
the right is the source, and the operand to the left is the destination. The 
processor acts upon the source first and the destination next. 
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In the following command, the operands are BX and AX. BX is the 
urce. When the operation is complete, the value of BX remains exactly what 
was before the operation began; the value of AX, the destination, matches 
.at of BX. 

MOV AX, BX 

There are three types of operands: immediate, register, and memory. 
Immediate Operands 


Immediate operands are constant values. In a double operand operation, an 
immediate operand can be the source operand only. In the following examples, 
the constant 9 is an immediate operand. In the first example, it is a 
constant. In the second example, it is a symbol for a constant. 

MOV AX, 9 

VAR1 EQU 9 

MOV AX, VAR1 

".agister Operands 

'hen the operand is a register, it is called a register operand. In the 
following double operand operation, both operands are registers. 

MOV AX, BX 
Memory Operands 

A memory operand directs the processor to an address to find some data or 
instruction. A memory operand is an offset from a base address. There are 
three kinds of memory operands. 

• indexed memory operands 

• direct memory operands 

• structure operands 

Direct memory operands , consisting of a single offset value, can be 
either the source or the destination. They do not use registers, but consist 
of labels, simple variables, and offsets. In the following example, VAR1 
represents an address rather than a symbolic constant. 

MOV AX, VAR1 

Indexed memory operands use the base and index registers, constants, 
displacement values, and variables, often in combination. By combining 
indexed operands, you create an address expression. 
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Indexed memory operands use square brackets to indicate that the 
expression evaluates to an address rather than data. In the following 
examples, VAR1 contains an address. In the first example, the processor 
fetches the data from the address indicated in VAR1 and copies it into BX. In 
the second example, the processor fetches the data 5 bytes further than the 
address stored in VAR1 and copies it into BX. 

MOV BX [VAR1] 

MOV BX [VAR1+5] 

A structure operand is an operand used exclusively with a structure. 

Once you define a structure, you can create a structure operand. Structure 
operands allow you to access any value by field name indexed through BP. For 
instance, through the use of structure operands, you can access parameter 
values passed on the stack, not just the value at the top. To learn more 
about structure operands, refer to Section 5.13, The STRUCTURE Directive. 
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CHAPTER 4 
OPERATORS 


There are four kinds of operators: arithmetic, relational, logical, and 
attributal. Arithmetic, relational, and logical operators combine or compare 
operands. Attribute operators override the attributes of operators, return 
the value of the attributes, or isolate fields of records. 


4.1 ARITHMETIC OPERATORS 


Eight arithmetic operators plus two shift operators provide the common 
mathematical functions. The arithmetic operators combine operands to form an 
expression that results in a data item or an address. With two exceptions, 
operands must be constants. 

• For plus only, one operand must be constant. 

• For minus, the left operand can be a variable or both operands can 
be variables, but the right operand must not be a variable if the 
left is constant. 

The eight arithmetic operators are as follows. 


* 

Multiply (operand * operand). The operands must be absolute 
numbers. j 


Example: MOV AL, 3*2 

/ 

Divide (operand / operand). The operands must be absolute 
numbers. 


Example: CMP CX, 100H/12 

MOD 

Modulo (operand MOD operand) Divide the left operand by 
the right operand and return the value of the remainder | 

(modulo). Both operands must be absolute. In the following 
example, you divide 17 into 100, returning decimal 15 into 

AX. 

; f 


Example: MOV AX, 100 MOD 17 
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(-operand). The value following the minus sign is negated. 

Add. (operand + operand)^ An operand evaluates to an ^ 

absolute number, a variable, or a label name. One operand 
must be constant; one may be a variable. 

Subtract the right operand from the left operand (operand - 
operand). The left operand can be a variable, or both 
operands can be variables. But the right operand can be a 
variable only if the left operand is also a variable and in 
the same segment. 


Shift right (operand SHR count) SHR is preceded by a 
numeric operand that evaluates to an absolute number and is 
followed by an integer that specifies the number of bit 
positions the value is to be right shifted. Each position 
shifted right divides the number in half. In the following 
example, the processor shifts 1100000 five places to the 
right, moving 11B into AX. 

Example: MOV AX, 1100000B SHR 5 


SHL Shift left (operand SHL count). SHL is preceded by a 

numeric expression that evaluates to an absolute number and 
is followed by an integer that specifies the number of bit 
positions the value is to be left shifted. With each bit 
position shifted left, the value of the original number J 

doubles. In the following example, 0110B shifts left five 
positions, moving 011000000B into AX. 

Example: SHL AX, 0110B SHL 5 


4.2 RELATIONAL OPERATORS 


The relational operator is a logical operator that determines whether a 
particular relationship exists between two operands. You use relational 
operators most often with conditional directives and conditional 
instructions. The syntax for the relational operator is as follows. 

operand relational operator operand 

The operands of relational operations can be absolute numbers or 
variable or label names defined in the current module. The result of a 
relational operation is an absolute number: it returns all I's for true and 
all 0*s for false. The relational operators are as follows. 
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EQ 

Equal. Returns true if the operands equal each other. 

NE 

Not equal. Returns true if the operands do not equal each other. 

LT 

Less than. Returns true if the left operand is less than the 
right operand. 

LE 

Less than or equal. Returns true if the left operand is less than 
or equal to the right operand. 

GT 

Greater than. Returns true if the left operand is greater than 
the right operand. 

GE 

Greater than or equal. Returns true if the left operand is 
greater than or equal to the right operand. 


4.3 LOGICAL OPERATORS 


AND, OR, AND XOR compare the binary values of corresponding bit positions of 
each operand. They return a value according to whether the state is true or 
false. The syntax for OR, XOR, or AND is: 

operand .logical operator, operand 

■ OT - is a binary operator that inverts the bits of the byte or the word 
gpSerand. The syntax of NOT is: 

.NOT.operand 

The logical operators are as follows. 


NOT 

Logical NOT. A binary operator that inverts the bits of the 
operand. It sets a bit if that bit position in the operand is 
clear, and it clears a bit if that position in the operand is 
set. 

AND 

Logical AND. Compares the bit positions of two operands and 
returns the result to the destination operand. It sets a bit 
if both corresponding bits of the original operands are set. 

It clears the bits if either one or both are clear in the 
original operands. Both operands must be treated as an 
unsigned number. 

OR 

Logical OR. Compares the bit positions of two operands and 
returns the result to the destination operand. It sets a bit 
in the result if either or both of the two corresponding bits 
of the original operands are set. It clears the bits if 
neither of the two corresponding bits of the original is set. 

Both operands must be treated as an unsigned number. 
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Exclusive OR. Compares the bit positions of two operands and 
returns the result to the destination operand. It sets a bit 
if one of the corresponding bits of the original operands is 
set and one is clear. It clears the bits if the corresponding 
bits if the original operands contain the same value. Both 
operands must be treated as an unsigned number. 


Table 4-1 illustrates the value of the logical operators when X and Y 
vary in value from true to false. 


Table 4-1. Logical Operations 


X 

Y 

X.AND.Y 

X.OR.Y 



TRUE 

TRUE 

TRUE 

TRUE 

FALSE 

FALSE 

TRUE 

FALSE 

FALSE 

TRUE 

FALSE 

TRUE 

FALSE 

TRUE 

FALSE 

TRUE 

TRUE 

TRUE 

FALSE 

FALSE 

FALSE 

FALSE 

TRUE 

FALSE 


4.4 ATTRIBUTAL OPERATORS 


The attributal operators override an operand's attributes. The operators are 
SEG, OFFSET, TYPE, SIZE, and LENGTH. They tell what the components of the 
memory address are and return their values. For this reason, they are often^^^A 
called value returning operators. The six analytic operators are as follows 


SEG 

Returns the base address of the segment, label, or variable. 

OFFSET 

Returns the offset of the variable or label. 

TYPE 

Returns the number of bytes of a variable. 

LENGTH 

Returns the number of type units (BYTE, WORD, DWORD, QWORD, 
TBYTE) allocated in all. If the DUP expression is not 
present, it returns a 1. 

SIZE 

Returns the total number of bytes allocated for a variable, 
which amounts to the product of LENGTH * TYPE. 

.TYPE 

Returns the mode and indicates whether the expression is 
external. 
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.4.1 SEG 


The SEG operator returns the base address of the segment enclosing the label 
or of the variable that immediately follows the operator. The syntax of SEG 
is: 

SEG label 

SEG variable 

In the following example, the processor returns the segment base address 
and stores it in AX. 

MOV AX, SEG VAR1 


4.4.2 OFFSET 


The OFFSET operator returns a constant equal to the offset of the variable or 
label from the beginning of the segment. The syntax of OFFSET is: 

OFFSET label 

OFFSET variable 

n the following example, the processor returns the offset for VAR1 and stores 
t in AX. 

MOV AX, OFFSET VAR1 

The following rules apply to the use of OFFSET. 

• OFFSET returns a relocatable value if the label or variable is 
relocatable. 

• OFFSET is unnecessary with DW and DD because the assembler applies 
an implicit OFFSET to these variables in address expressions. 

• When you use an ASSUME with a GROUP directive, OFFSET returns the 
segment offset unless you use the group versions of the segment 
override operator. In the following example, you declare GOB to be 
part of a GROUP, and you want the group offset of GOB. 

MOV BX, OFFSET DGROUP:GOB 
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4.4.3 TYPE 


If the operand is a variable, the TYPE operator returns a value equal to the 
number of bytes of the variable type as follows. 

BYTE = 1 

WORD . = 2 

DWORD = 4 

QWORD = 8 

TBYTE = 10 

STRUC = the number of bytes declared by STRUC 

If the operand is a label, the TYPE operator returns NEAR or FAR. The syntax 
for TYPE is as follows. 

TYPE label 
TYPE variable 

In the following example, the TYPE operator returns the number of bytes 
of VAR1 to AL. 

MOV AL, TYPE VAR1 


4.4.4 LENGTH 


The LENGTH operator returns the number of type units (BYTE, WORD, DWORD, 

QWCRD, TBYTE) for the variable of its argument. LENGTH accepts only one 
variable as its argument. You can use it for setting a counter for a loop 
that accesses the elements in an array. The syntax of LENGTH is: 

LENGTH variable 

If you define the variable with a DUP expression, LENGTH returns the 
number of type units duplicated, that is, the number that precedes the first 
DUP in the expressions. For example, the length returned in the following 
example is 100. 

VAR3 DW 100 DUP(l) 

If you do not define the variable with a DUP expression, LENGTH returns a 1. 

In the following example, VAR1 is an array with 100 elements duplicated 
only once. Consequently, the LENGTH operator returns 100 and stores 100 in CX. 

VAR1 DW 100 (DUP)1 

MOV CX, LENGTH VAR1 
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4.4.5 SIZE 


The SIZE operator returns the total number of bytes allocated for a variable 
SIZE is the product of the value of LENGTH times the value of TYPE (SIZE - 
LENGTH * TYPE). The syntax of SIZE is: 

SIZE variable 


example, the variable is two bytes long, and the length 
is 100 i100 * 2 = 200). Thus, the size is 200. ™ 

VAR1 DW 100 (DUP) 1 

MOV BX, SIZE VAR1 ;get total bytes in array 


4.4.6 .TYPE 


,. 1 is written Wlth a beginning period to distinguish the .TYPE operator from 

e TYPE operator. Use the .TYPE operator to gain information about the type 
of data with which you are dealing. .TYPE informs you of two data 

TYPE C is^ 1StlCS: thS m ° de an<1 Whether the data is external. The syntax of 


.TYPE variable 

Upon finding the .TYPE directive, the assembler returns a byte of 
information. The least significant two bits of this byte indicate the mode. 

0 the mode is Absolute. 

1 the mode is Program Related. 

2 the mode is Data Related. 

3 the mode is undefined. 


The most significant bit that the assembler returns to you is the 
external bit. If the high bit is: 


0 the expression is not external. 

1 the expression contains an external. 

The defined bit is 20H (the sixth bit from the 0 bit). If the defined 


the expression is undefined or external, 
the expression is locally defined. 


■i w? U ^ SG t** 16 -TY pE operand with macros, external programs that are 
available for repeated use. Often you must test an argument type to make a 
decision about how to continue the program. For example: 
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EXCEL MACRO X 
LOCAL Z 

Z = .TYPE X 

IF Z 

In the example, .TYPE tests the mode and type of X through a conditional 
directive. Depending upon the evaluation, the assembler either assembles or 
omits the block of code, beginning with IF Z. 


4.5. SYNTHETIC OPERATORS 


There are six synthetic operators: PTR, THIS, Segment Override, SHORT, HIGH, 
and LOW. They build memory-address operands from their components. Synthetic 
operators are called override operators because they override the segment, 
offset, type, or distance of variables and labels. The synthetic operators 
are as follows. 


PTR 

Overrides the type (BYTE, WORD, DWORD, etc.) or the 
distance (NEAR or FAR) of an operand. 

THIS 

Creates an operand with the distance or type you 
specify. 

Segment Override 

Overrides the assumed segment of an address 
expression (a label, variable, or memory operand).^® 

SHORT 

Overrides the distance attribute for JMP 
instructions within 127 bytes. 

HIGH or LOW 

Isolates the high or low byte of a word. 


4.5.1 PTR 


The PTR operator overrides the type (BYTE, WORD, DWORD) or the distance (NEAR 
or FAR) of an operand. The PTR operator temporarily redefines an expression 
that is defined in another place. The syntax of the PTR operator is as 
follows. 

attribute PTR expression 

The attribute is the new type or distance; the expression is the operand 
whose attribute you wish to override. It can be a variable name, a label 
name, an address or register expression, or an integer that represents an 
offset. 
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In the following example, the PTR operator allows the variable, VAR1, 
|^^previously defined as a word, to be referenced as a byte for this instruction. 


VAR1 DW 

MOV BYTE PTR VAR1, AL 


The PTR operator can also resolve ambiguous references. The assembler 
generates an error when you try to move a byte variable into a word register. 
If you are not sure of the size of the variable, you can use the PTR to make 
sure that both the source and the destination are the same size. You can also 
use PTR to override the type attribute if, for example, you wish to access a 
word variable as type byte. 


4.5.2 THIS 


The THIS operator is very similar to the PTR operator. The THIS operator 
builds a memory address of a specific type without actually leaving any 
specific memory for it. Through the THIS operator, you create an operand in 
which you specify the type of distance. The syntax of the THIS operand is as 
follows. 


THIS distance 
THIS type 


THIS distance creates an operand with the distance attribute you 
specify, an offset equal to the current location counter, and the segment base 
address of the enclosing segment. 


THIS type creates an operand with the type attribute you specify, an 
offset equal to the current location counter, and the segment base address of 
the enclosing segment. 


The following examples illustrate the use of the THIS operators. In the 
first example, you define TAG as a byte. In the second example, you define 
SPOTCHECK as NEAR. 


TAG EQU THIS BYTE 
SPOTCHECK = THIS NEAR 


4.5.3. Segment Override 


The assembler gets segment address information from two sources.' The ASSUME 
statement indicates the address of each item of data; default registers 
provide addresses for anonymous references with no variable names. The 
default registers are the current CS for labels and the current DS or ES 
registers for variables. To override the default registers, you need the 
segment override operator for forward references. 
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The segment override operator is a colon. The segment override 
indicates to the assembler that no matter what instructions it previously 
received concerning the segment of a variable, label, memory operand, or 
expression, it must use the segment register that precedes the colon. A 
segment override serves as an ASSUME statement for that command only. 

You can use the segment override operator with segment register names 
(CS,DS,SS,ES), with segment names, or with group names. The syntax of the 
segment override expression can be any of the following. 

Segment register: address expression 

Segment name: address expression 

Group name: address expression 

The segment register named in the format statement is one of the four 
segment registers; the segment name is a name defined in the SEGMENT 
directive; and the group name is a name defined in the GROUP directive. The 
address expression can be a label, a variable, or a memory operand. 

In the following examples, VAR2 becomes associated with the extra 
segment register, and FAR_LABEL becomes associated with segment name, CSEG. 

MOV AX, ES:VAR2 

MOV CSEG:FAR LABEL, AX 


4.5.4 SHORT 


The SHORT operator overrides FAR distance attributes of labels used as targets 
for the JMP instruction. The SHORT operator tells the assembler that the 
distance between the JMP statement and the label specified is within than 127 
bytes. 


The major advantage of using the SHORT operator is to save one byte. 
When a label is forward referenced, it carries a 2-byte pointer. Because a 
label within a range of 256 bytes requires only a single-byte pointer, the 
SHORT operator saves the extra byte. If the label is not within 256 bytes, 
however, an error occurs. The syntax of the SHORT operator is: 

SHORT label 

In the following example, the label REPEAT is less than 127 bytes away 
from the SHORT operator. 

JMP SHORT REPEAT 


REPEAT: 
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1.5.5 HIGH and LOW 


The HIGH and LOW operators provide 8080 assembly language compatibility. HIGH 
and LOW are byte isolation operators. HIGH isolates the high 8 bits of an 
absolute 16-bit value or address expression while LOW isolates the low 3 
bits. The syntax of the HIGH and LOW operators is as follows. 

HIGH expression 

LOW expression 

In the following commands, the high byte of WORDJ/ALUE is moved to the 
high order byte of register AH; in the second command, the low order byte of 
VAR__1 is moved to the low byte of register AL. 

MOV AH, HIGH WORDVALUE 

MOV AL, LOW VAR 1 


4.6 RECORD SPECIFIC OPERATORS 


All of the record specific operators isolate record fields, consecutive bits 
within a word or byte. The record specific operators are as follows. 


Shift Count 

Counts the number of bits from the low end of the record 
to the low end of the field. 

WIDTH 

Counts the width of the field or record in bits. 

MASK 

Determines the maximum value of the field (if all the 
bits in it are on and if all the bits in the other 


fields of the word are off). 


Before you can use record specific operators, you must create a record 
by using the RECORD directive. A record is 1 to 16 bits long, and it is 
defined by fields that are also 1 to 16 bits long. To create a record defined 
by fields, you need the RECORD directive, which breaks a word up into fields 
used with any of the record specific operators. For information concerning 
the record directive, refer to Chapter 5, Data Directives. 


4.6.1 SHIFT COUNT 


Once you have created a record, you can use the record specific operators. 

The shift count operator helps you to know where each field begins. The shift 
count tells you how many bits the lowest bit of a field is from the the lowest 
bit in the byte or word. The shift count is the number of bits the field must 
be right shifted for the lowest bit of the field to be set in the lowest bit 
£f the record byte. 


Operators 


4-12 


For example, VAR2 is a 16-bit record that contains three fields: 
FIELD1, FIELD2, and FIELD3. The record is diagrammed in Figure 4-1. 


13 BITS 7 BITS 
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Figure 4-1. The Shift Count of a Record 


From the lowest bit in FIELD1 to the lowest bit of the whole word is 13 
bits. Therefore, FIELD1 has a shift count of 13. From the lowest bit in 
FIELD2 to the lowest bit of the whole word is 7 bits. Therefore, FIELD2 has a 
shift count of 7. The lowest bit of FIELD3 is the lowest bit of the word. 
Therefore, the shift count of FIELD3 is 0. 

The syntax of shift count is: 

record field name 

When you want to isolate the value in one of these fields, you enter its 
name as an operand. In the following example, you move FIELD2 into CL, thus 
isolating its value. 

MOV DX, VAR2 

MOV CL, FIELD2 


4.6.2 WIDTH 


You can use the WIDTH operator with either the field name or the record name. 
When you use the WIDTH operator with the field name, the assembler returns the 
number of bits in that particular field. When you use the WIDTH operator with 
a whole record, the assembler returns the number of bits in the record. 

The syntax of WIDTH is: 

WIDTH record field name 
WIDTH record 
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Figure 4-2 illustrates the width of the fields within the record, 
case, the WIDTH of the record is 16 bits, one word. 


In 


FIELD 1 - 3_ FIELD 2 ~ 6- _ FIELD 3 — 7 


Bit Number IS 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 

VAR 1 


Figure 4-2. The Width of a Record Field 


The WIDTH of FIELD1 equals 3; the WIDTH of FIELD2 equals 6; and the 
WIDTH of FIELD3 equals 7. In the following example, the command moves the 
WIDTH of FIELD2 into the low byte of the C register. 

MOV CL, WIDTH FIELD2. 


4.6.3 


MASK 


The MASK operand isolates a field and turns on all of the bits in that field. 
In other words, the value that the field takes on after being masked is the 
maximum value the bits in that position can have. All of the other bits in 
the record are turned off and have a zero value. 


In Figure 4-3, the byte variable VAR3 is composed of two fields: FIELD1 
and FIELD2. FIELD2 is masked. Consequently, all of the bits in FIELD1 are 
set, and all of the bits in FIELD2 are clear. The MASK of FIELD2 equals 15, 
or the maximum number that bits 0, 1, 2, and 3 can equal in binary notation if 
they are all set. 
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FIELD 1 


FIELD 2 



Figure 4-3, The Mask of a Field 


The syntax of the MASK operator is: 

MASK record-field name 

The following operation isolates FIELD2, turns on all of its bits, and 
AND’s it with bits 0, 1, 2, and 3 in VAR2. 

MOV DL, VAR2 

AND DL, MASK FIELD2 

4.7 ORDER OF PRECEDENCE FOR OPERATORS 


As in algebra, there is an order of precedence in the way that expressions are 
evaluated. The processor evaluates the operations of higher precedence first; 
it evaluates operations of equal precedence from left to right. Parentheses 
alter the order of precedence. 

The following list contains the order of precedence from highest 
precedence to the lowest. All operators in a single item have the same 
precedence. 

1. LENGTH, SIZE, WIDTH, MASK 

Items inside parenthesis, angle brackets, or square brackets 
Structure variable operand: variable.field 

2. Segment override operator 
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3. PTR, OFFSET, SEG, TYPE, THIS 

4. HIGH, LOW 

5. *, /, MOD, SHL, SHR 

6. +, - (both unary and binary) 

7. EQ, NE, LT, LE, GT, GE 

8. Logical NOT 

9. Logical AND 

10. Logical OR, XOR 

11. SHORT, .TYPE 


Operators 



5-1 


CHAPTER 5 
DATA DIRECTIVES 


Data directives define and initialize data by type and value. Through the 
data directives, you can reserve space for data, assign value to data, set and 
redefine constants and labels, create data structures, define the attributes 
of a name, change the default radix of numbers, and change the value of the 
location counter. The data directives are as follows. 

ASSUME 

The Data Allocation Statement: 

DB 

DD 

DQ 

DT 

DW 

EQU 

EVEN 

INCLUDE 

LABEL 

NAME 

ORG 

PROC...ENDP 

.RADIX 

RECORD 

STRUC ...ENDS 


5.1 THE ASSUME DIRECTIVE 


The ASSUME statement tells the assembler which logical segment (or group) a 
segment register points to. You can enter from one to four register names in 
the ASSUME statement. The syntax of the ASSUME statement is as follows. 

ASSUME segment register:segment name (,segment register:segment name]... 
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The segment names can be: 

• The name of a segment declared in the SEGMENT directive. 

• The name of a group declared with the GROUP directive. 

• An expression: either SEG variable name or SEG label name. 

• NOTHING. 

In the following example, the ASSUME statement tells the assembler that 
it should address DATA1 with offsets from DS, CGROUP with offsets from CS, 
STACK1 with offsets from the SS, and that there should be no address in ES. 

ASSUME DS:DATA1, CS:CGROUP, SS:STACK1, ES:NOTHING 

NOTHING tells the assembler that that particular segment register points 
to NOTHING. Each time you access a variable through that register, you must 
use a segment prefix. NOTHING is the default value. For this reason, it is 
important to use the ASSUME statement before you attempt to access any memory 
instructions. 

If you do not use an ASSUME statement or an ASSUME NOTHING, the 
assembler cannot find the location of data unless you use a register prefix 
for each variable, symbol, or label in your program. 

In the following example, the prefixes DS: and ES: indicate that the 
assembler should address VAR1 with offsets from the DS register and VAR2 with 
offsets from the ES register in this one instance only. 

DS:VAR1 

ES:VAR2 


5.2 DATA ALLOCATION STATEMENT 


The data allocation directive tells the assembler how much space to allocate 
for data, and what the initial value of the variable is. 

There are five data types, as Table 5-1 illustrates. 


Table 5-1. The Five Data Types 


Data Type 

Size in Bytes 

Meaning of Symbol 

DB 

1 

Byte 

DW 

2 

Word 

DD 

4 

Double word 

DQ 

8 

Quadruple word 

DT 

10 

Ten bytes 
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The syntax of the data allocation directive is as follows. 


[variable name] DB (or DW, DD, DQ, DT) initial value [,initial value] 

The field following the DB specifies how many bytes, words, double 
words, quadruple words, or ten bytes that the assembler should reserve and 
what their initial values should be. There are many kinds of statements that 
can follow the DB. They include: 

• A constant or expression. For example, the following statement 
allocates space for one byte of data and initializes it with the 
value of 4. 

DB 2+2 

• A question mark, used for reserving space without initializing it to 
any particular value. For example, the following statement reserves 
10 bytes of data with no particular value. 

DT ? 

• An address expression (for DW and DD only). For example, the word 
"TABLE" in the following example is a label representing an address. 

DB PTR DD TABLE 

• An ASCII string that initializes consecutive bytes in a DB 
statement. In this case, the characters are stored sequentially 
with the first character assigned to the lowest address. For 
example, the following statement reserves 14 bytes for'MARK MIKE 
PAUL’. 

MULT_CHAR DB 'MARC MIKE PAUL* 

• The expression DUP plus an expression in parentheses. DUP indicates 
that the assembler should initialize each of the memory locations in 
the data block to the value in parentheses. In the following 
example, you request 200 words initialized to alternating 0's and 
l's. 

DW 100 DUP (0, 1) 

• A number of constants. These constants initialize as many memory 
locations as are required with the stated value. In the following 
example, the statement initializes three bytes with the values 1, 2, 
and 3. 

DB 1, 2, 3 

• A combination of the preceding. The following example shows four 
words initialized with 2, 4, an undetermined value, and 02F 
hexadecimal. 

DB 2, 4, ?, 02FH 
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5.3 E£U 


EOU equates the names of symbols with constants/ expressions/ mnemonics/ 
addresses, or registers. There are a number of rules regarding the use of EQU. 

• The expression that follows EQU cannot be external. 

• Once you use EQU to define a name, you cannot redefine the name. 

« You cannot use EQU within a structure. 

• The name cannot have a value before you use EQU to define it. If 
the symbol already has a value/ you use the equal sign (=) to 
redefine it. 

The syntax of EQU is: 

symbol EQU expression 

Through EQU/ the symbolic name becomes another name for the symbol in the 
expression. The expression can be: 

• a name of a symbol 

• an index reference 

• an instruction name 

• a record expression 

• a 16-bit absolute constant 

• a floating-point value 

• a segment prefix and operands 

In the following examples/ SYMB1 is equated with the constant 50/ and SYMB2 is 
equated with an index reference/ the base pointer plus 4. 

SYMB1 EQU 50 
SYMB2 EQU [BP+4] 

5.4 EQUAL SIGNS 


You can use equal signs to define and redefine an expression. The main 
difference between the equal signs and EQU is that equal signs allow you to 
redefine a label without causing an assembly error. The syntax is: 

symbol = expression 

The expression must be a valid expression. In the following example, SYMB 
becomes equated with 50. 

SYMB = 50 
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5.5 The EVEN DIRECTIVE 


It is often necessary to use even boundaries to address an element so that it 
begins on a word boundary. The EVEN directive causes the assembler to assign 
an even address to,an instruction. If the instruction already has an even 
address, the assembler ignores the EVEN directive. If you use EVEN with a 
byte-aligned segment, the assembler issues an error message. 

The syntax of the EVEN directive is: 

EVEN 


5.6 THE INCLUDE DIRECTIVE 


The INCLUDE directive inserts a source code from an alternate assembly source 
file into the current source file. The INCLUDE directive allows you to repeat 
frequently used code. The syntax of the INCLUDE directive is as follows. 

INCLUDE file name 

The file name is any valid file specification. If the device 
designation is different than the currently logged drive or device, the source 
file name specification must include it. 

When the assembler finds the INCLUDE directive, it searches for the file 
named and assembles it into the current program immediately following the 
INCLUDE directive. When the assembler reaches the end of the file, it resumes 
assembling the current program. If the assembler cannot find a program with 
the name indicated in the INCLUDE statement, it sends out an error message and 
the assembly aborts. 

Nested INCLUDES are legal. The file inserted with an INCLUDE statement 
can contain an INCLUDE statement of its own. This is not a recommended 
procedure because of the amount of memory taken up when you nest INCLUDE 
statements. 

In the following example, the assembler includes the file RECORD.TST in 
the current source file. 

INCLUDE RECORD.TST 
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5.7 THE LABEL DIRECTIVE 


The LABEL directive causes the assembler to associate the current segment 
offset with a label name. The attributes of name are segment, offset, and 
type. The syntax of LABEL is as follows. 

label name LABEL type k 

You can use the label name for either code or data. The type entry must 
be BYTE, WORD, DWORD, structure-name, or record-name for data areas. When you 
use a LABEL for code, you must address it through the CS register. The type 
must be NEAR or FAR for executable code. In the following examples, VAR1 is 
NEAR while VAR2 is FAR. 

VAR1 LABEL NEAR 

VAR2 LABEL FAR 


5.8 THE NAME DIRECTIVE 


The NAME directive gives a module a name. Through the NAME directive, you can 
make a name represent code, data, or a constant. The name field can begin in 
any column although normally names begin in column one. The format of the 
NAME directive is: 

NAME name of module 

You cannot use a reserved word as the name of the module. 

Each module has a name. If you do not use the NAME directive, the 
assembler uses the first six characters of the TITLE statement for the module 
name if they are legal. If you do not use the TITLE statement, or if the 
first six characters of the TITLE statement are not legal, the assembler uses 
the source file name as the module name. Use one of the following formats to 
make a name represent code. 

NAME: directive, instruction, or nothing 
NAME LABEL NEAR or FAR 
EXTRN NAME: NEAR or FAR 

Use one of the following formats to make a name represent data. 

NAME LABEL size 
NAME expression 
EXTRN NAME: size 
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The size refers to the data type, BYTE, WORD, etc. Use one of the following 
■prmats to make a name represent a constant. 

W NAME EQU constant 
NAME = constant 
NAME SEGMENT attributes 
NAME GROUP segment names 

For further information about any of the individual directives attached 
to NAME, refer to each directive separately, i.e., EQU, SEGMENT, GROUP etc. 


5.9 THE ORG DIRECTIVE 


Through the ORG directive, you can reset the location counter to locate code 
or data at a particular offset in the segment. The syntax of the ORG 
directive is as follows. 

ORG expression 

The expression must evaluate to a two-byte absolute number. In the 
first of the following examples, the expression following ORG evaluates to 
120H. In the second example, the dollar sign represents the current value of 
the location counter. The instruction causes the location counter to move 2 
bytes forward. 

■ ORG 12OH 

^ ORG $+2 


5.10 PROCEDURES 


A procedure is a sequence of instructions. Through the procedure, you can 
organize code by dividing it into blocks, each of which performs a distinct 
function. Although you can JMP into and out of a procedure, a procedure 
usually receives control through a CALL instruction and passes control back 
through a RET instruction. Two statements, PROC and ENDP, indicate the entry 
point and exit point of the procedure. The format of a procedure is as 
follows. 
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procedure name PROC [NEAR/FAR] 


REX 


procedure name ENDP 

The procedure name labels the beginning address of the procedure. NEAR 
or FAR tells the assembler which CALL instruction to use. If the procedure is 
within 64K bytes of the CALL, the assembler saves only the offset in the IP on 
the stack. If the procedure is farther away than 64K bytes, the assembler 
saves two addresses: the offset in the IP and the segment address from the CS. 

Just as there are two kinds of calls, there are two kinds of return 
instructions: NEAR and FAR. The NEAR restores the value of the original 
offset, and the FAR restores the values of the base address and the offset. 

If you don't specify either FAR or NEAR, the default is NEAR. You use 
FAR if the procedure name is an operating system entry point or if you call 
the procedure from code that has another ASSUME CS value. 

Combining the PUBLIC directive with the PROC statement permits you to 
make external calls or other external references to the procedure. You can 
call a procedure through either a JMP or CALL. You can also nest procedures. 
The following is an example of a simple procedure that adds two byte values 
together. 

ADD_UP PROC NEAR 
MOV DH, AH 
ADD DH, BH 
RET 

ADD_UP ENDP 

Parameters are the input values passed on to procedures. For example, 
in the preceding example, the procedure receives input values in AH and BH. 
There are three ways of passing parameters to a procedure: by placing values 
in registers as previously illustrated by making values in a variable in the 
data region available to the procedure, and by putting the values onto the 
stack and allowing the procedure to access them. 
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.11 THE .RADIX DIRECTIVE 


The .RADIX directive permits you to change the input radix from the default of 
10 to any base in the range of 2 to 16 for types DB and DW. The syntax of the 
.RADIX directive is as follows. 

.RADIX expression 

The expression is always in decimal radix, regardless of the current 
input radix. The default input radix for all constants is decimal. The 
following directive causes the assembler to interpret all numbers that come 
after it as being in octal notation. Number 24 is equivalent to Decimal 20. 

.RADIX 8 

MOV BX, 24 

The .RADIX directive does not affect variables defined as type DD, DQ, 
or DT. The assembler evaluates numeric values of this data type as decimal 
unless you append a data type suffix to the value. The .RADIX directive does 
not affect the values in the .OBJ, .LST, or .CRF output files. 


5.12 THE RECORD DIRECTIVE 


Before you can use record specific operators, you must create a record. A 
Record is 1 to 16 bits long, made up of fields from 1 to 16 bits long. To 
create a record defined by fields, you need the RECORD directive, which breaks 
a word up into fields used with any of the record specific operators. The 
syntax of the RECORD directive is as follows. 

record name RECORD fieldname: width [=expression],[...] 

When you use field name as a value in an expression, its value is the 
shift count to move the field to the far right. Using the MASK operator with 
the field name returns a bit mask for that field. 

Width is a constant in the range of 1-16 that specifies the number of 
bits in the field. If the total width of all declared fields is larger than 8 
bits, the assembler uses 2 bytes; otherwise, it uses 1 byte. 

The expression contains the initial or default value for the field. If 
the field is 7 or more bits wide, you can use an ASCII character as the 
expression. For example: 

HIGH:7=*Q' 
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In the following example/ a record named REC1 is broken up into three 
records: HIGH, which is 4 bits long and initialized at 1; MID/ which is 3 
bits long and initialized at 2; and LOW, which is also 3 bits long and 
initialized at 5. 

REC1 RECORD HIGH:4=1/ MID:3=2/ LOW:3=5 

The first field uses the most significant bits of the record. 
Subsequently declared fields use the succeeding bits to the right. If the 
fields do not total exactly 8 bits or 16 bits, the entire record is shifted to 
the right so that the last bit of the last field is the lowest bit of the 
record. Unused bits remain at the high end of the record. 

Figure 5-1 illustrates the placement of bits for the following RECORD 
directive after the processor shifts the fields to the right. 

REC2 RECORD HIGH:5/ MID:4/ L0W:1 


UNDECLARED 

—^ - 


HIGH - 5 


MID - 4 LOW - 1 


Bit N — 15 14 13 12 11 10 


98765 43 21 


Figure 5-1. The Placement of Bits in a Record 


To initialize records after the first RECORD directive/ use a format 
similar to that of the data allocation statement. 

[name] record name <[expression] [/...]> or 

[name] record name repeat value DUP([^expression] [/...])) 

The name is optional. If you indicate a name, it refers to a label for 
the first byte or word of the record storage area. The record name is the 
name of the record in the RECORD directive. 
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The expression contains the values with which you want to initialize the 
Record fields. Parentheses are required around the second expression 
H>1 lowing DUP. If you leave the expression blank, the value that you gave the 
*ield in the orginal RECORD directive applies. If no such value exists, the 
value is indeterminate. In the following example, RECNAME takes on the value 
5. 

REC1 RECNAME <5> 

If you want to reinitialize fields, name tjhe record and specify the 
value that you want the field to have. Commas indicate that you want the 
field to retain its present value. In the following example, the HIGH and the 
MID fields retain their indeterminate values while the LOW field becomes 
valued at 7. 

REC1 <,,7> 

You can use records in expressions as operands in the following form. 

record name [value[,...]] 

The value entry is the value you wish to place in the record field. The 
value entry is optional, but the angle brackets must appear even if no values 
are within them. In the following instruction, you use the field MID as an 
operand, masking it to set the like bits in DX. 

AND DX, MASK MID 


5.13 The STRUCTURE DIRECTIVE 


A structure is a group of byte and word offsets that you can reference from 
any base. The STRUC directive is a very specialized type of data allocation 
statement. The assembler allocates no storage to the structure. The 
structure becomes associated with an area of memory and a base value when you 
reference it in an instruction. 

At times, you may wish to define a complex type of data. For example, 
you may wish to define the dimensions of a cube and compose a data structure 
in which you can call up each dimension. You can define a data structure 
using the data allocation statement coupled with the STRUC directive. 
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The syntax of the STRUC directive is as follows. 
Structure name STRUC 


[variable name] DB or DW or DD or DQ or DT Expression 
Expression DUP expression [,...] 


Structure name ENDS 

The following structure creates the dimensions of a cube. 

CUBE STRUCT 
L DW ? 

W DW ? 

H DW ? 

CUBE ENDS 

You can either define the value of the variables within the STRUC as you 
create them, or you can define them afterward. The preceding structure does 
not define the value of the variables. If you do not define the variables 
within the structure, you must include a definition like the following one 
that gives the values of 1, 2, and 3 to L, W, and H respectively. 

SQUARE CUBE <1,2,3> 

The syntax of the statement that initializes and allocates structures 
after you have declared them is: 

[name] structure name Expression, [,...]> 

The name refers to an optional name for the bytes that you defined in 
the structure. The structure name is the name you assigned from the 
STKUC/ENDS directives. The expression specifies the list of initializing or 
optional override values. 

You can define the data types within the structure as two sorts: 
overridable or not overridable. You can redefine overridable types; you 
cannot redefine those that are not overridable. 

A simple field with only one entry is overridable; a field with more 
than one entry or with a DUP expression is not overridable. Strings can be 
overridden by other strings. However, if they are not the same length, the 
assembler either pads or truncates the overriding string, depending upon 
whether it is shorter or longer than the original string. 
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) 



The following structure presents two over ridable fields and two fields 
that cannot be overridden. 

S STRUCT 

FIELD1 DB 1,2; not overridable 
FIELD2 DB 10 DUP(?) not overridable 

FIELD3 DB 5; overridable 

FIELD4 DB •JOHN DOE*; overridable 
S ENDS 


To override the value of the two overridable fields, FIELD3 and FIELD4, 
use the following statement. 

NEW S <,,7,'BOB HALLER’> 

The commas command the assembler to leave FIELD1 and FIELD2 with their 
original values; the assembler replaces the 5 of FIELD3 with a 7, and the 
string 'JOHN DOE' of FIELD4 with 'BOB HALLER*. The assembler truncates the 
last two letters of HALLER because the overriding string is two characters 
longer than the original string. 

The STRUC directive allows you to access any field within the variable 
through the special dot (.) operator. The format of structure operands is as 
follows. 




variable.field 


he variable is the user name given in the structure initialization 
statement. It can be anonymous, such as the name of an indexed memory 
operand. The field name is the user name given in the data allocation 
statement within the structure. The value of the field entry is the offset 
within the structure. 


In the following example, you set up a structure, initialize GIRAFFE 
with the value 16 using the name L0NG_NECK, and then use L0NG_NECK.GIRAFFE as 
a structure operand. 

200 STRUC 

GIRAFFE DB ? 

ZEBRA DB ? 

GAZELLE DB ? 

ZOO ENDS 

L0NG_NECK ZOO <16, 5, 7> 

MOV AL, LONGJJECK. GIRAFFE 


) 
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CHAPTER 6 

USING PROGRAM MODULES AND FUNCTIONS 


The Wang PC assembly language is a flexible programming language. With it 

v« U n C3 vI se P aratel y assembled program modules into a single program* 
Your ability to combine different modules into consecutive memory locations 

uae easil Y manageable program units that you can test and debuq 
ua y. You can also use high-level languages in modules and link them 
to your assembly language program. llut tnem 

of » are -? a ^ assembl y directives especially designed to make elements 

available to other modules. During assembly, the assembler allots 
p . es e elements. All of the modules, however, are assembled 

out a If ► inke S f esolves a11 of the references and creates one file 

»f^ h ®. parate modules> module has a name. To name a module use 

the NAME directive described in Section 5.8. moauie, use 


USING THE SAME SYMBOLS IN MULTIPLE MODULES 



The assembler codes local symbols with only an offset address, but it codes 
external symbols with an offset and a base address. You should distinguish 
local symbols from external symbols so that the assembler can code the^ymbols 

sr2-•**“»b.iyT.TSf' 


6.1.1 The PUBLIC Directive 


2*«25SlJ 1 5! CtlV * inf °™ S the assembler that the symbol that follows PUBLIC 
as follows! f USe ln ° th0r m ° dUleS- The syntax o£ the PUBLIC statement is 


PUBLIC symbol [,symbol]... 
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The symbol can be a number, a variable, or a label. It can be a label 
defined with the PROC directive. It cannot be a register name or a symbol 
defined with EQU by floating point numbers or by integers larger than 2 
bytes. In the following example, you declare VAR1 to be PUBLIC. 

VAR1 DW 50 
PUBLIC VAR1 


t .1.2 The EXTRN Statement 


Once you define a symbol and declare it to be PUBLIC, you can use it in 
another module. To access the symbol from another module, use another special 
statement, the EXTRN statement. The EXTRN statement calls upon the PUBLIC 
L*vcnbol from another module. The syntax of the EXTRN statement is as follows. 

EXTRN symbol:type [,symbol:type] 

Symbol refers to a symbol that you define and declare to be PUBLIC in 
another module. Type can be any of the following types, but it must be valid 
for the symbol. 

• BYTE, WORD, or DWORD 

• NEAR or FAR for labels or procedures defined with a PROC directive 

• ABS for pure numbers whose implicit size is word but includes byte 

For example, if you wanted to call upon VAR1 from the first module, yoi^ 
would write: 

EXTRN VAR1:BYTE 

You must define the type, which is byte, when you use the EXTRN statement but 
not when you use the PUBLIC statement. You defined the variable type in the 
module in which you used the PUBLIC statement so you do not need to 
redefine it. 
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Placement of the EXTRN statement affects assembly. When you place EXTRN 
kinside a SEGMENT/ENDS pair, the assembler assumes that the external symbol 
Belongs to that logical segment. Therefore, the assembler associates the 
Segment name with the symbol and the segment base address. If EXTRN is 
outside a SEGMENT/ENDS pair, the assembler assumes that the symbol belongs to 
none of the logical segments of that module. 

To help the Linker locate the address of an EXTRN symbol if you do not 
know it, you can use an ASSUME statement with a SEG operand or an explicit 
segment prefix. The following example returns the segment value of VAR1. 

ASSUME DStSEG VAR1 

The Linker tries to resolve incorrectly defined or undefined symbols. 

It takes the offset relative to a given statement and searches for the symbol 
definition. If the definition is more than 64K bytes away, the linker cannot 
find it and returns an error message. 


6.2 COMBINING SEGMENTS 


To save processing time, to clarify your program, and to save space, you 
should combine the logical segments of two program modules whose total size is 
less than 64K bytes. When you combine the segments, the assembler addresses 
both segments through the same segment register. 

■ To combine corresponding logical segments from two modules, you must use 
^he same name for both segments or use different segment names but GROUP 
directives with the same group name. For example, if you name the data 
segment in the first module FUNCT_DATA, you must name the data segment in the 
second module FUNCT_DATA. 

To use the SEGMENT statement for the combination of modules, you need to 
indicate the attributes of the SEGMENT in the modules that you combine. The 
syntax of this SEGMENT statement differs from the simple SEGMENT declarative 
statement. The syntax of the SEGMENT statement that combines logical segments 
from different modules is as follows. 

segment name SEGMENT align type, combine type, 'class name' 


6.2.1 Segment Name 


The segment name is any legal name that you give the segment. Make sure the 
names of all segments you wish to combine are the same. 
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6.2.2 Align Type 


The alignment tells the linker on what kind of boundary you want the segment 
to begin. The first address of the segment is determined by one of the 
following alignment types. 


PAGE 

The low byte of the address is 0. 

PARA 

The low nibble of the address is 0. 

WORD 

The low bit of the address is 0; the word is aligned on 
an even boundary. 

BYTE 

The address can occur on either an even or an odd boundary. 


PARA, an address divisible by 16, is the default. You should avoid 
using the BYTE align type because it is slow and often results in boundary 
errors. 


6.2.3 Combine Type 


The combine type can be any of the following. 


PUBLIC 

Combines data segments or code segments with 
common base addresses. 

STACK 

Combines stack segments with common base 
addresses. 

MEMORY 

Causes segments to be placed at highest 
available segments in memory. 

AT paragraph address 

Permits labels and variables to be defined at 
fixed offsets within fixed areas of storage; 
places segment at the specified paragraph 
address. 

COMMON 

Overlaps loaded segments so that the length of 
the common area is the length of the longest 
segment. 

no entry 

--- 1 

Creates private segments that may share names, 
but each has its own base address. 
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The PUBLIC Combine Type 


Hub; 
W: omi 


ILIC and STACK are the two most common combine types. Use the PUBLIC 
:ombine type for segments that are addressed from the same segment register 
and that occupy adjacent memory units. PUBLIC allows code and data segments 
from different modules to be combined. 

Because of the PUBLIC combine type, when the linker links the followina 
modules, all of the variables in the modules are addressed from the same data 
segment address. 

MODULE 1 


DATA_SEG 
DATA_A 
DATA SEG 


SEGMENT 

DB 

ENDS 


PUBLIC 

"A,B,C,D M 


M0DULE_2 

DATA_SEG 
DATAJ3 
DATAC 
DATA SEG ENDS 


SEGMENT 

DB 

DB 


PUBLIC 

1 * 2,3 


Stack Combine Type 

lb combine stacks from two different modules, use the STACK combine type. 

When the linker finds the STACK combine type, it links separate stack segments 
rom separate stack modules. This new stack region is as large as the 
combined space of all the separate stack regions from all the separate modules. 

. , In J; he followi ng program, the LABEL directive addresses the top of the 

links"tho. 6 name °5 th * s ^ Ck se 9 inen t ™ each module is identical. The linker 
register P arate modules lnto one segment addressed from one stack segment 

MODULE 1 


DATA_STACK SEGMENT 
DB 10 DUP(?) 

TOP S LABEL 


STACK 

BYTE 


MODULE 2 


DATAJSTACK SEGMENT 
DB 25 DUP(?) 

TOP STACK LABEL 


STACK 

BYTE 
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6.2.4 The Class Name 


The class name indicates that the assembler should place certain previously 
combined regions next to each other in memory. The assembler does not address 
them from a common base, however. In the following example, the same class 
name causes the assembler to place the two segments in adjacent areas of 
iremory. 


DATA_STACK SEGMENT WORD STACK 'A_REGION' 

DATA~SEG SEGMENT WORD PUBLIC 'A_REGION* 

The use of the class name 'A_REGION' within single quotations causes the 
linker to place the two segments adjacent to one another in memory. 


6.3 USING GROUPS 


A group is a set of segments that the assembler addresses from the same 
segment register. The segments share a base address. When the total of all 
the segments occupy less than 64K bytes of memory, you can combine them to 
make your program more efficient. When you use groups, you can use the offset 
alone to address each item; furthermore, one register contains the address of 
all of the segments. 

You can use a group name: 

• as an immediate value, e.g., MOV AX, DGROUP; 

• in an ASSUME statement, e.g., ASSUME DS:DGROUP; or 

• as an operand prefix to combine segments, e.g., DW DGROUP:VAR1. 

The syntax of the group statement is as follows. 

group name GROUP segment name [,segment name]... 

The segment name can be: 

• assigned by a SEGMENT directive and it can be a forward reference, or 

• an expression: SEG variable or SEG label. 

The following group statement combines the code, data, and stack 
segments into one group, addressable from the address of the label. 
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WHOLE_GROUP GROUP D SEG, C SEG, S SEG 


r i 


■ Once you define a group, you must load its address into a segment 
^register. In the following example, the processor loads the group address 
into the DS register. 

MOV AX, WHOLE_GROUP 
MOV DS, AX 

You must also identify the group address to the assembler as follows. 

ASSUME DS:WHOLE_GROUP 

The offset of a variable or label from its group base address is 
different from the offset from its segment base address. The OFFSET operator 
returns the OFFSET from the segment even though the variable is grouped, 
unless you use a group override. The syntax of the group override is as 
follows. 

OFFSET group name:symbol 

For example, if VAR1 were a variable in SEG1, and you wish to get the offset 
address from the group of which it is a part, use the following statement. 

OFFSET WHOLE GROUP:VAR1 
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CHAPTER 7 

MACRO AND REPEAT BLOCKS 


7.1 MACROS 


A macro is a block that you code once and repeat within the module without 
recoding. A macro is a procedure that you can repeat in a variety of 
modules. Once coded, you can invoke a macro at appropriate places in the 
module, causing its expansion. 


7.1.1' Creating a Macro 


The first step in using macros within your program is to write the macro 
f°de. A macro definition associates a name with a block of instructions which 
|ay use dummy arguments as place holders. The assembler replaces these du»y 
Arguments with actual parameters. The number of dummy arguments is only 
limited by the length of the macro statement line. 


The macro name and the dummy arguments are formed according to the rules 
for any other symbolic name. Each macro begins with a MACRO statement and 
ends with an ENDM statement. Commas separate the dummy arguments. The syntax 
of a macro is shown as follows. 

macro name MACRO [dummy,... ] 


ENDM 

The following is an example of a small macro that adds two numbers 
together and moves them to a third location. This operation requires three 
dummy arguments. 

ADD1 MACRO XX,YY,ZZ 
PUSH AX 
MOV AX, XX 

ADD AX, YY 

MOV ZZ, AX 

POP AX 
ENDM 
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If you don't pass any parameters to the macro block, you can use a macr< 
call with no dummy arguments. The syntax of the parameterless macro statemei 
is as follows. 




macro name MACRO 


7.1.2 Invoking a Macro 


After you code your macro, you can invoke it. When the assembler encounters a 
macro call, it expands the macro call statement by bringing in and assembling 
the appropriate macro block at that spot within the program unit. To invoke a 
macro, enter its name and parameters into your program. The syntax of the 
call statement is as follows. 

macro name [parameter,...] 

For example, suppose you wish to use the macro in Subsection 7.1.1., 
ADD1, in your program. Enter a call using variable names rather than dummy 
arguments. 

ADD1 VAR1, VAR2 , VAR3 

When the assembler encounters the macro call, it searches for a macro called 
ADD1 in the symbol table it builds in the first pass. If it finds a macro of 
the same name in the table, the assembler expands the code into your program, 
substituting the actual parameters for the dummy list in corresponding order. 
In this case, it puts the following code into your program. 

PUSH AX 

MOV AX, VAR1 

MOV AX, VAR2 

MOV VAR3, AX 

POP AX 

The assembler is very flexible in interpreting the parameters. If the 
number of parameters in the macro call is greater than the number of dummy 
arguments in the macro dummies, the assembler ignores the extra actual 
parameters. If there are fewer parameters in the macro call than there are 
arguments in the macro, the assembler interprets the extra dummy arguments as 
being null. 

If you place angle brackets around a set of parameters, the assembler 
interprets them as being just one parameter. In the first of the following 
two examples, the assembler interprets ADD1 as having three parameters; in 
the second example, the assembler interprets ADD1 as having only one parameter 

ADD1 1,2,3 

ADD1 <1,2,3> 
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7,1.3 Deleting a Macro 


The PURGE directive deletes macros from the text of your program. Purging a 
macro is helpful if you need the space for more current macros. After you 
call up the file using the INCLUDE directive, you can edit out the macros that 
you do not need through the PURGE directive. In this way, you retain only the 
macro(s) that you wish to use. The syntax of the PURGE directive is as 
follows. 

PURGE macro name 

The following example uses the INCLUDE and the PURGE directive to edit 
out one macro but retains the other macros in the file. 

INCLUDE MACRO.LIB 

PURGE MAGI 

If you invoke MAC1 after using the preceding sequence, the assembler returns a 
syntax error because MAC1 is not in the file. 


7.1.4 The LOCAL Statement 


|If you wish to repeat code within a macro, you can retain a unique address for 
Bach repetition of each symbol through the LOCAL statement. For example, if 
P£ou want to repeat ADD1 from Subsection 7.1.1 three times and retain the 
values of VAR1, VAR2, and VAR3 in each repetition, you would use the LOCAL 
statement to do so. The LOCAL directive must precede all other types of 
statements in the macro block. The syntax of the LOCAL statement is as 
follows. 

LOCAL dummy [,dummy...] 

The following example shows a macro block in which the LOCAL statement 
causes each of the variables. A, B, C, D, and E to have new values each time 
they pass through the loop. The assembler gives each repetition of each 
variable a unique offset. For example, on the first round A takes the offset 
0000 and the label 770000, the form that each unique label of the variables in 
the listing file takes. On the second round, A takes the offset 0009 and the 
label ??0005. In each repetition, the labels retain their unique addresses 
and values. In the first listing file, the assembler substitutes 0C00H and 
OBEH for the dummy arguments NUM and Y. In the second repetition, it gives 
the dummy arguments the parameters of 03C0H and OFFH. 
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The Macro Block: 

FUN SEGMENT 

ASSUME CS:FUN,DS:FUN 
FOO MACRO NUM,Y 

LOCAL A,B,C,D,E 
A: DB 7 
B: DB 8 
C: DB Y 
D: DW Y+l 
E: DW NUM+1 
JMP A 
ENDM 

LAZY PROC 

FOO 0C00H, OBEH 
POO 030H, OFFH 

RET 

LAZY ENDP 

The first listing of the listing file: 


0000 

07 

+ 

770000: 

DB 

7 

0001 

08 

+ 

770001: 

DB 

8 

0002 

BE 

+ 

770002: 

DB 

OBEH 

0003 

00BF 

+ 

770003: 

DW 

OBEH+1 

0005 

0C01 

+ 

770004: 

DW 

0C00H+1 

0007 

EB F7 

+ 


JMP 

770000 

second 

listing of 

the listing file: 


0009 

07 

+ 

770005: 

DB 

7 

000A 

08 

+ 

770006: 

DB 

8 

OOOB 

FF 

+ 

770007: 

DB 

OFFH 

oooc 

0100 

+ 

770008: 

DW 

0FFH+1 

000E 

03C1 

+ 

770009: 

DW 

03C0H+1 

0010 

EB F7 

+ 


JMP 

770005 

0012 


FUN 

ENDS 






END 



7.2 REPEAT BLOCKS 


In the Wang PC assembly language, repeat blocks allow you to repeat code 
automatically. Repeat blocks differ from macro blocks in that macros are part 
of the code of the program. Repeat blocks, however, can be used inside macro 
blocks, where they are called up with the macro itself. 
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^^^krepeat 

^^^Vhence 

aaeirrr 


The parameters of the macro block are more flexible than those of a 
irepeat block. You can pass parameters to the macro block when you call it; 
hence, you can change the parameters of a macro. In the repeat block, you* 
assign the parameters as part of the code block. Therefore, you must know the 
parameters in advance. 


7.2.1 Repeat Block 


The syntax of the Repeat Block (REPT) is similar to that of a macro. You 
introduce it by a REPT statement, and it ends with an ENDM as shown. 

REPT expression 


ENDM 


The expression that follows REPT indicates the number of times the processor 
should repeat the statements between the REPT statement and the ENDM 
statement. The processor evaluates the expression as a 16-bit unsigned 
number. The assembler generates an error if the expression that follows REPT 
contains an external symbol or an undefined operand. 




In the following REPT block, the value of X increases by one each time 
■he code repeats. The code repeats ten times as indicated by the statement: 
REPT 10. Thus, 10 bytes are allocated, with initial values from one to ten. 


X=0 

REPT 10 
X=X+1 
DB X 
ENDM 


7.2.2 Indefinite Repeat Block 

The Indefinite Repeat Block (IRP) is similar to the REPT, but this block 
repeats for each parameter. The syntax of the IRP is as follows. 

IRP, dummy, <parameters> 


ENDM 
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Parameters, enclosed in angle brackets, are any legal symbols, strings, 
numerics, or character constants. As the Repeat Block executes, each 
parameter in sequence gives the value to the dummy argument. Each repetition 
substitutes the next parameter of each dummy in the block. If the parameter 
is null (<>), the block processes once with a null parameter. 

In the following example, the IRP repeats for each parameter 1 through 
10. Thus, 10 bytes are allocated, with initial values from 1 to 10. 

IRP X, <1,2,3,4,5,6,7,8,9,10 

DB X 

ENDM 

The syntax of the IRP may be slightly different inside a macro block. 
The dummy argument is a variable that can receive its value from the 
parameters of the macro call. In the following example, X receives its value 
from the parameters of the macro call, MAC1. 

MAC1 MACRO X 
IRP Y, <X> 

DB Y 

ENDM 

ENDM 

The parameters of the macro call supplies the value of the X, as shown. 

MAC1 <1,2,3,4,5,6,7,8,9,10> 

All the items are passed as a single parameter. When the assembler assembles 
the IRP, the macro expansion is: 

IRP Y, <1,2,3,4,5,6,7,8,9,10 


7.2.3 Indefinite Repeat Character 


The Indefinite Repeat Character (IRPC) is slightly different from the REP or 
the IRP. The syntax of the IRPC is as follows. 

IRPC dummy, string 

The assembler repeats the statements in the block once for each character in 
the string. As in the IRP, the assembler substitutes the next character in 
the parameters of the macro call for the dummy argument. In the following 
example, X takes on the values of 1 to 10. 

IRPC X, 0123456789 

DB X+l 
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7.3 



angle 


SPECIAL MACRO OPERATORS 


are several special operators that you use with macros: the ampersand, 
brackets, the semicolon, the exclamation mark, and the percent sign. 


7.3.1 Ampersand 


In order to use a quoted string as a dummy parameter., you must place an 
ampersand (&) immediately before the string. The ampersand is used in macro 
expansion to concatenate text or symbols. Form a symbol from text and a dunmy 
as follows. 

ERRGEN MACRO X 
ERROR&X: PUSH BX 
ABX MOV BX, '&X 1 
AB&cX JMP ERROR 
ENDM 


When you call ERRGEN A, the assembler generates the following code in your 
program. 




ERRORA: PUSH BX 
ABX MOV BL, 'A* 
ABA JMP ERROR 


in this example, the assembler substitutes the quoted string *A' for 


When you nest macros, you need to supply as many ampersands as there are 
levels of nesting, as follows. 

ERRGEN MACRO X 

IRP Z, <1,2,3> 

XS&Z DB Z 
ENDM 
ENDM 


Because the macro includes a repeat block, you need three ampersands. The 
assembler removes an ampersand each time it repeats the block of code. 


7.3.2 Angle Brackets 


The Wang PC assembly language treats all text between angle brackets as a 
single literal. If you put the parameters following the IRP directive inside 
angle brackets, the assembler interprets them in the following ways. 
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• As a single parameter, even if you use commas to separate the itemp 
in the list. 

• As literal characters, not symbols or indicators. For example, if 
you use a semicolon within angle brackets, the assembler interprets 
it as a character rather than as an indicator preceding a comment. 

When using nested macros, you need to use as many sets of angle brackets 
around the parameters as there are levels of nesting. 


7.3.3. Two Semicolons 


The assembler does not expand a comment preceded by two semicolons (;;) in a 
MACRO or repeat block. .LALL causes the assembler to list all comments not 
preceded by ;; during macro expansion. .XALL, the default, causes the 
assembler to disregard comments when expanding macro code. 

Listing comments during macro expansion can cause out-of-memory errors. 
If you are using .LALL, use a double semicolon (;;) before comments, unless 
you specifically wish to have a comment in the expansion. In the following 
example, the assembler overlooks the comment that follows the double 
semicolons. 

;; This is a comment. 


7.3.4 Exclamation Mark 


An exclamation mark (!) indicates that the next character in an argument is 
literal. Therefore, !; causes the assembler to interpret the semicolon as a 
literal rather than as an operator to indicate comments. 


7.3.5 Percent Sign 


You use the percent sign {%) only in a macro argument to convert the 
expression that follows it to a number in the current radix. Without the 
percent sign, the assembler substitutes the text of the macro argument for the 
symbolic parameter. When the percent sign is present, the assembler replaces 
the dummy argument for the numeric equivalent. The format of the percent 
operator is the following. 

^expression 
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In the following example, the command STRING ^NUMBER causes the 
assembler to substitute the value of NUMBER (1234) for NUM in the concatenatec 
string ’abcd&NUM'. The result that the assembler generates is , abcdl234'. 

NUMBER EQU 1234 
STRING MACRO NUM 
DB ’abcd&NUM' 

ENDM 

STRING ^NUMBER 
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CHAPTER 8 

CONDITIONAL DIRECTIVES 


There are ten conditional directives in the Wang Professional Computer 
assembly language: IF, IFE, IF1, IF2, IFDEF, IFNDEF, IFIDN, IFDIF, IFB, 

IFNB. You can use a conditional directive to test the condition of blocks of 
code in much the same way that you can in higher level languages. The 
condition is either true or false. The value of true is any number other than 
zero; the value of false is zero. If the condition is true, control passes to 
the next instruction in the conditional block; if it is false, control passes 
to an ELSE statement, which processes an alternative block of code, or to the 
code following the ENDIF statement if there is no ELSE. All arguments to a 
conditional must to known on pass 1. Otherwise, errors occur. 

All types of conditional blocks have the same format: 

IF argument 


[ELSE 


.] 

ENDIF 

Each IF statement must have a matching ENDIF statement to terminate the 
conditional just as each ENDIF statement must have a matching IF statement. 

If an IF statement does not match an ENDIF statement, the assembler generates 
an error. If an ENDIF statement does not have an accompanying IF statement, 
the assembler generates a "Not in conditional block" error. 

The ELSE directive is optional. The ELSE block is an alternative block 
of code that the processor processes if the original condition tested is 
false. You can only use one ELSE block for one IF statement. The ELSE block 
always refers to the most recent IF statement that is not followed by an ENDIF. 
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You can nest conditionals up to 255 levels. The following figure 
illustrates the nesting of conditionals: 


IF Statement. . . 

IF Statement. . . 

IF Statement. . . 

ENDIF 

ELSE. . . 

ENDIF 

ENDIF 

Figure 8-1. The Nesting of Conditionals 


The expressions following the IF and IFE statements must evaluate to 
either true or false upon the first pass of the assembler. Therefore, the 
values in the expression following IF or IFE must be predefined and absolute. 

The assembler can define the conditional expressions that are found 
within a macro block upon either the first or the second pass. Therefore, 
IFDEF and IFNDEF may contain symbolic expressions. 


8.1 THE TEN CONDITIONAL DIRECTIVES 


In the Wang PC assembly language, there are ten conditional directives, each 
of which tests for slightly different conditions. They are as follows. 


IF expression If the expression is true, the assembler assembles 

the statements within the conditional block. 

IFE expression If the expression is false, the assembler assembles 

the statements within the conditional block. 


IF1 


If the assembler is in pass 1, it assembles the 
statements in the conditional block. 
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IF2 If the assembler is in pass 2, it assembles the 

statements in the conditional block. 

IFDEF symbol If the symbol is either defined or external, the 

assembler assembles the statements in the conditional 
block. 

IFNDEF symbol If the symbol is not defined and not external, the 

assembler assembles the statements in the conditional 
block. 

All of the following conditional directives normally appear in macro 
blocks. The arguments must appear in angle brackets as shown. They are 
usuaily dummy arguments that are replaced by parameters passed by the macro 

IFIDN <argument 1>, Argument 2> If the string in Argument 1> is 

identical to the string in 
<argument 2>, the assembler 
assembles the conditional block. 
The macro call must pass two 
identical parameters to meet this 
condition. 

IFDIF Argument 1>, Argument 2> If the string in Argument 1> is 

different from the string in 
<argument 2>, the assembler 
assembles the conditional block. 

The macro call must pass two 
different parameters to meet this 
condition. 

IFB <argument> If there is no argument in the 

angle brackets < > or if argument 
is blank, the assembler assembles 
the conditional block. When you 
call the macro, a parameter 
replaces the argument. If the 
macro call does not specify a 
parameter, the expression is blank, 
and the assembler assembles the 
block. 
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IFNB <argument> If there is an argument in the 

angle brackets and if the macro 
call specifies a parameter, the 
argument is neither blank nor null, 
and the assembler assembles the 
conditional block. 


Conditional Directives 


9-1 


CHAPTER 9 

LISTING DIRECTIVES 


There are three types of listing directives: those that control the format of 
the file, those that serve as programming aids, and those that control what is 
assembled in the file. The format control directives control page breaks and 
the appearance of titles, the programming aid directive causes text to be 
listed on the screen during assembly, while the assembly control directives 
help you to control the amount of space used in memory. 


9.1 FORMAT DIRECTIVES 


the 


There are three format directives: PAGE, SUBTTL, and TITLE. They do what 
their names indicate. The PAGE directive sets up page breaks or the size of 

i. h ® the * ITLE dir ective causes a title to appear on each page, and the 

1 IBTITLE directive causes subtitles to appear on each page. 


9.1.1 The PAGE Directive 


The PAGE directive has two very distinct functions depending upon the initial 
syntax of the command. PAGE followed by no arguments or with an optional + 
causes the assembler to start a new output page. The syntax of this PAGE 
command is either PAGE + or PAGE. 


When the assembler encounters the PAGE + command, it puts a form feed 
character into the listing file at the end of the page; it increments the 
major page number, i.e., the chapter or unit number; and it resets the minor 
page number to 1, i.e., the page within the chapter. When the assembler 
encounters the PAGE command without the +, it puts a form feed character into 
e listing file at the end of the page and increments the minor portion of 

r no nano niimnoi. * 
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The PAGE directive followed by length and width arguments sets up either 
the length or the width of the page or both. The syntax of the command is as 
follows, 

PAGE [length] [width] 

If you include the value of length, that value becomes the new page length as 
measured by the lines of the page. The page length starts at 10 or greater 
and goes to 255 or less. The default page length is 50 lines per page. 

The value of width, if included, becomes the new page width as measured 
in columns. The page width can be no greater than 132, and the default is 
80. The following command, for example, sets the length of the page at 58 
lines and the width of the page at 60 columns. 

PAGE 58, 60 


9.1.2 The TITLE Directive 


The TITLE directive directs the assembler to list a title on the first line of 
each page. The title can be up to 60 characters long. The first six 
characters of the title are used as the module name unless a NAME directive 
specifies a different name. The syntax of the TITLE directive is as follows. 

TITLE text 

For example, the following TITLE directive causes the name PROG1 to 
appear at the top of every page of the listing. If the NAME directive does 
not specify otherwise, the module name is now PR0G1. 

TITLE PROG1 


9.1.3 The SUBTTL Directive 


The SUBTTL directive causes the assembler to list a subtitle on the line after 
the title. The subtitle can be up to 60 characters long. The assembler 
truncates more than 60 characters. 
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Each time the assembler encounters SUBTIL followed by a na me it 
ip bhe old subtitle with the n ® w one. If you wish to turn off the 
'th. l tS*' 1 °! the °«tput, enter a SUBTIL with a null string in place of 

the title. The syntax of the subtitle directive is as follows. 


SUBTIL text 


For example, if you have named a portion of 
enter the following. 


your program Special I/O Routine, 


SUBTIL SPECIAL I/O ROUTINE 


SPECIAL I/O ROUTINE appears under the title of each page 
change the subtitle, enter a new one as follows. 


If you wish to 


• SUBTIL MACRO ADD1 


If you wish to turn off SUBTTL, enter the following. 

SUBTTL | 

Through this directive, the subtitle line on the listing file is left blank. 



9.2 % OUT DIRECTIVE 


- 16 *** directive causes the assembler to list text on the terminal durina 

for 6 ?^ y i f 0UT . us f ful for displaying progress through a long assembly^ 

for displaying the value of conditional assembly switches. 7 

... displays text on Passes of the assembler. If you only want to 

., - * on one pass ' use the IF1 or IF2 directives with the %OUT. The use of 

Sl„tT/^°T n r d by the . IF1 directive causes the assembler to dispL^or 
Hiropf° Ut the texb on the flr st pass. The use of the %OUT with the IF2 

ective causes the assembler to display or to print out on the second pass 
The syntax of the %OUT Directive is as follows. **”* 

%OUT text 

following example, the message "Assembly half done" appears on both 

PaSScS* 


%OUT Assembly half done 
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In the next example, the message 
IF1 

%OUT Pass 1 is started 
ENDIF 


"Pass 1 is started" appears only on pass one^ 


In the final example, the message "Pass 2 is started" appears only on pass two. 
IF2 

%OUT Pass 2 is started 
ENDIF 


9.3 TEXT SUPPRESSION DIRECTIVES 


Several directives are designed to suppress text. Through these directives, 
you can control the number of lines in your listing file, the listing of false 
conditional expressions, the listing of the source and object code produced by 
a macro, and the creation of cross-references in portions of your 
cross-reference file. 


9 . 3.1 The .LIST and .XLIST Directives 


The .LIST and .XLIST directives allow you to control the number of lines thati 
go into the listing file. For example, if you only want to see the listing ■ 
for four lines, you can suppress the listing for all of the other lines in t nm 
file, saving both processing time and space. The .LIST directive causes the 
assembler to list all lines with their code. It is the default condition. 

The .XLIST suppresses all listing. If you have created a list file and 
the assembler encounters the .XLIST directive, it stops listing the source and 
object code. .XLIST overrides all other listing directives. The assembler 
will not list, even if it encounters another type of listing directive, until 
it encounters a .LIST directive. When the processor encounters a .LIST 
directive, it begins to create a list program again. The syntax of .LIST and 
.XLIST is as follows. 

.LIST 

.XLIST 
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In the following example, the assembler suspends listing when it 
encounters the .XLIST directive and resumes listing when it encounters the 
.LIST directive. 


.XLIST 


9.3.2 The .SFCOND, .LFCOND, and .TFCOND Directives 


The .SFCOND, .LFCOND, and .TFCOND directives allow you to control the asseatoly 
of false conditionals. If you need to save space in memory, the Suppression 
of false conditionals provides a method. 

The .SFCOND directive suppresses the parts of the listing file that 
contain conditional expressions that evaluate to be false. The /X switch, a 
directive that you use when you call upon the assembler, also suppresses false 
conditionals. The .SFCOND directive overrides the /X switch. For more 
|^nformation on switches, see Chapter 1, Assembling the Program. 

• The .LFCOND directive causes the listing of conditional expressions that 
evaluate as false. This directive overrides the /X switch. 


The first time the assembler encounters a .TFCOND directive, it 
suppresses false conditionals; the second time, it restores the listing of 
the false conditionals; the third time, it suppresses them, and so on. 7ou 
can also use the .TFCOND directive in conjunction with the the /X switch. If 
you use the /X switch when you answer the listing file prompt, the assembler 
suppresses the listing of false conditionals. If the /X switch is active when 
the assembler encounters a .TFCOND directive, the assembler reverses the 
normal outcome of a single .TFCOND directive. That is, normally the first 
.TFCOND directive causes the suppression of false conditionals. When an /X 
switch is active, however, the assembler restores the listing. When it 
encounters the second .TFCOND and the /X switch is active, it suppresses false 
conditionals. The /X switch toggles whatever condition was in effect at that 
time. The following table illustrates the use of .TFCOND. 
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Table 9-1. The Use of .TFCOND with /X 


Number 

.TFCOND 

Effect of /X 

Effect of No /X 

First 

.TFCOND 

Restored 

Suppressed 

Second 

.TFCOND 

Suppressed 

Restored 

Third 

.TFCOND 

Restored 

Suppressed 

Fourth 

.TFCOND 

Suppressed 

Restored 


9.3.3 The .XALL, .LALL, and .SALL Directives 

The .XALL, .LALL, and .SALL directives allow you to control the listing of the 
source and object code produced by a macro. These directives can help you 
save space in memory. 

.XALL causes the assembler to list only the macro source code and object 
code that generate code. Source lines that do not generate code, such as 
comnent lines for example, are not listed when .XALL is in effect. .XALL is 
the default condition. 

.LALL causes the assembler to list the complete macro text for all 
expansions, including lines that do not generate code. However, comments 
preceded by two semicolons (;;) are suppressed even when you use the .LALL 
directive. To list comments inside macro blocks, use the COMMENT directive 
and .LALL. 

.SALL causes the assembler to suppress the listing of all text and 
object code produced by macros. 

9.3.4 The .CRSF and .XCREF Directives 


Through the .CREF and .XCREF directives, you can control the listing of 
cross-references in your file. These directives allow you to save s^pace in 
memory. If you use the .XCREF directive without arguments, it suppresses the 
creation of a cross-reference file. .XCREF remains in effect until the 
assembler encounters .CREF to restart the creation of a cross-reference file. 
.CREF causes the assembler to create a cross-reference file and is the default 
condition. When the default .CREF is in effect, it is overridden by .XCREF 
just as .XCREF is overridden by .CREF. 
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When you use .XCREF followed by variables, the assembler does not place 
variables in the cross-reference file. Only the variables are affected by 
e cross-referencing. The syntax of the .XCREF directive used with variables 
is as follows. 


.XCREF variable list 


In the following example, ARG1, ARG2, ARG3, and ARG4 will not appear in the 
cross-reference file. 


.XCREF ARG1, ARG2, ARG3, ARG4 
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CHAPTER 10 
THE LISTING FILE 


10.1 THE LISTING FILE 


The assembler can produce three separate files: the object file, the binary 
file that is sent on to the linker for further processing; the cross-reference 
file, which is the source file for CREF, the cross-reference program; and the 
listing file, which lists the code and offsets generated for each statement 
along with the errors in the program. 

The listing file provides you with information that you can use to debug 
your program. It is composed of two parts. The first part of the listing 
file includes the following information. 

• The source file 

• The line number for each line of the source file 

• The offset of each element in the source file 

• The object code in either hexadecimal or octal notation (hexadecimal 

is the default; octal notation appears if you use the /O switch when 
you invoke the assembler 

• Whether a cross-reference file is being created 

• The object and source code from a macro 

• The object and source code from an INCLUDE statement 

The second part of the listing file includes the following information: 

• The name and length in bytes of all macros 

• The name, width, and fields of all structures 

• The name, size, align type, combine type, and class of all segments 
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• The name, type, value, and attributes of all symbols 

• The number of warnings in the program 

• The number of errors in the program 

10.2 THE FIRST SECTION OF THE LISTING FILE 


The following is an example of the first section of a listing file. 


Line 

Offset 

Code 

Source Program 

1 

2 



NAME PR0G1 

3 



ASSUME DS:ABC, CS:ACD 

4 

0000 


ABC SEGMENT 

5 

0000 

0005 

VAR1 DW 5 

6 

0002 

0003 

VAR2 DW 3 

7 

8 

9 

0004 


ABC ENDS 

0000 


ACD SEGMENT 

10 

0000 

B8 -R 

START: MOV AX, ABC 

11 

0003 

8E D8 

MOV, DS, AX 

12 

0005 

A1 0000 R 

MOV AX, VAR1 

13 

0008 

8B IE 0002 R 

MOV BX, VAR2 

14 

oooc 

03 C3 

ADD, AX, BX 

15 

000E 


ACD ENDS 

16 



END START 


In PR0G1 

, offset addressing begins with 0000 twice: at the beginning of 


the ABC Segment and the beginning of the ACD Segment. The assembler counts 
the size of each element in bytes from the beginning of each segment. You can 
find the size of each element by subtracting its offset from the offset of the 
next line. MOV AX, ABC is three bytes long (0003-0000), for example, while 
MOV AX, VAR1 (0005-0003) is two bytes long. 

The line of code is the hexadecimal translation of the binary 
instructions that the processor requires to run the program. These 
instructions provide the programmer with the following information. 
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• the op code for the instruction 

• how long the operand is 

• whether the operand is in a register or in memory 

• the addressing mode used in this instruction 

• in which registers the elements that add up to the offset address 
are located 


• where the displacement, the 16 bit-value specified in the 
instruction, can be found 


• which register is used in register-mode addressing 

• whether there is a segment override' in the instruction 

• where the result should be stored in a double operand operation 

• whether the instruction contains all the bits or whether it needs to 
be extended to form a 16 bit operand 

• the data required for the instruction 




Each digit of a hexadecimal number translates 
ether form a byte, while four digits form a word. 
0005, gives both the value and the size of VAR1. 
digits translate to a word in binary notation. 


into a nibble; two digits 
Thus, the code on line 
The four hexadecimal 


The processor must be able to locate information in order to process 
it. The offsets of VAR1 and VAR2 are stated in their codes. The offset of 
VAR1 is 0000, while the offset of VAR2 is 0002. In the instruction MOV AX, 
VAR1, the code is A1 0000 R while in the instruction MOV BX, VAR2, the code 
is 8B IE 0002 R, naming the locations of VAR1 and VAR2 within the codes 
themselves. 


A number of special symbols for the Linker occur throughout the code. 
They are as follows. 


R 

Indicates relocatable code. This code can be placed in 
memory at a location chosen by the Linker. It does not 
have to be placed at any fixed point. 

E 

Indicates an external symbol that the Linker must resolve. 


Refers to a segment name, a group name, or a segment ! 

variable. It is used in moving the address of a segment 
or group to a register or in a JMP operation. The linker 
resolves the real address of the symbol. 
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There are no external symbols in PR0G1. However, line 10 contains both^^^k 

the symbol for a segment name (-) and the R symbol indicating that the cod^^B 

is relocatable. Lines 12 and 13 also contain the R symbol, indicating that 
the two variables are relocatable and that the Linker roust resolve their final 
addresses. 

A number of other symbols can occur in a listing program. The following 
listing file of an incomplete program contains a number of symbols that did 
not occur in PR0G1: 


1 

0000 


STACK SEGMENT WORD STACK 

'STACK 1 

2 

= 0000 


HEAPBEG 

EQU 

THIS BYTE 

3 

0000 

14 [ 


DB 

20 DUP(?) 

4 


?? 




5 



] 



6 






7 

= 0014 


SKTOP 

EQU 

THIS BYTE 

8 

0014 


STACK 

ENDS 


9 

10 

0000 


MAINSTARTUP 

SEGMENT 

•MEMORY 1 

11 



DGROUP GROUP DATA, STACK,HEAP, CONST, MEMORY 

12 



ASSUME CS: 

MAINSTARTUP, 






DS:GROUP, 


13 




ES:DGROUP, SS:DGROUP 

14 






15 




PUBLIC BEGXQQ 

16 






17 

0000 



BEGXQQ PROC 

FAR 

18 

0000 

B8 -R 



MOV AX, DGROUP 

19 

0003 

8E D8 



MOV DS, AX 

20 

0005 

8C 06 0022 R 


MOV CESXQQ, ES 

25 

oooc 

26: 8B IE 

0002 


MOV BX, ES:2 

26 

0011 

2B D8 



SUB BX, AX 

27 

0013 

81 FB 1000 



CMP BX, 4096 

28 

0017 

7E 03 



JLE SMLSTK 

29 

0019 

BB 1000 



MOV BX, 4096 

30 

001C 



SMLSTK: 

REPT 4 

31 





SHL BX, 1 

32 





ENDM 

33 

001C 

D1 E3 


+ 

SHL BX,1 

34 

001E 

D1 E3 


+ 

SHL BX,1 

35 

0020 

D1 E3 


+ 

SHL BX,1 

36 

0022 

D1 E3 


+ 

SHL BX,1 

37 

0024 

8B E3 



MOV SP, BX 

38 





. 

39 





. 

40 





. 

41 

0069 

EA 0000 — 

— R 


JMP FAR PTR BEG 
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45 

46 007E 

47 

48 0000 

49 

50 

51 


52 

0000 



53 

0000 

9A 

0000 - E 

54 




55 

0005 



56 

0005 

9A 

0000 -E 

57 

000A 

9A 

0000 -E 

58 

000F 

9A 

0000 -E 

59 

0014 

C7 

06 0020 R 0000 

60 

00 

2E 

0020 R 

61 

00 IE 




62 

63 

64 

65 0037 


BEGXQQ ENDP 


MAINSTARTUP ENDS 

ENTXCM SEGMENT WORD ‘CODE’ 
ASSUME CS: ENTXCM 
PUBLIC ENDXQQ, DOSXQQ 

BEG PROC PAR 

CALL ENTGQQ 

ENDXQQ LABEL FAR 
CALL ENDOQQ 
CALL ENDYQQ 
CALL ENDUQQ 
MOV DOSOFF, 0 
JMP DWORD PTR DOSOFF 
BEG ENDP 


ENTXCM ENDS 




END BEGXQQ 


f There are a number of symbols in the above text that did not appear in 
ROGl. They are as follows. 
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The assembler uses two more symbols that do not appear in either 
program. They are the following._ 


c 

indicates that the line comes from an INCLUDE statement 

nn/ 

indicates that the REP or LOCK prefix instruction is present 


10.3 THE SYMBOL TABLE 


The assembler composes the symbol table so that the assembler has easy access 
to a wide variety of information, such as where to find symbols; the size, 
align, combine and class type of segments and groups; the type value and 
attribute of symbols; the size, the number of fields in, and the offset of the 
fields of a structure; the size of, the number of fields in, the bit shift of 
the fields in a structure, the size of the mask of, and the initial value of 
the fields in a record; and the length of macros. 

The symbol table is divided into four separate areas. 

• macros 

• structure and records 

• segments and groups 

• symbols 

If your program contains no elements in any one category, that category does 
not appear in the symbol table. 

In PR0G1, the symbol table contains only two parts: 1) segments and 
groups and 2) symbols since the program itself contains only those symbols. 

The symbol table for PR0G1 is as follows. 


Segments and groups: 



Name 

Size 

align 

combine class 

ABC. 


0004 

PARA 

NONE 

ACD. 


000E 

PARA 

NONE 

Symbols: 






Name 

Type 

Value 

Attr 

START. 


L NEAR 

0000 

ACD 

VAR1. 


L BYTE 

0000 

ABC 

VAR2. 


L BYTE 

0002 

ABC 


Warning Severe 
Errors Errors 
0 0 
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T.3.1 The Listing of Macros 


If your program contains macros, they are listed first in the symbol table. 
They appear as follows. 

MACROS; 


Name Length i_: /- -:■ k utrr; 

BIOSCALL. 0002 

DISPLAY. 0005 

DOSCALL. 0002 

KEYBOARD. 0003 


The names of all the macros that appear in your program are listed under 
Name. The size of the macros is listed under Length. The number refers to a 
32-byte block unit. The macro BIOSCALL is 64 bytes long (2 x 32), while 
DISPLAY is 160 bytes long (5 x 32). 


10.3.2 The Listing of Structures and Records 




While structures are composed of various fields of bytes, records are composed 
I various fields of bits. Two subdivisions of the structures and records 
^Ible apply exclusively to records: mask and initial. An example of a 
itructure listing in the symbol table is the following. 


Name 

Width 

# fields 


Shift 

Width 

PARMLIST . 

001C 

0004 

BUFSIZE. 

0000 


NAMESIZE . 

0001 


NAMETEXT. 

0002 


TERMINATOR .... 

001B 



Initial 
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In the previous example, the unindented name, PARMLIST, is the name of 
the structure; the four indented names are the names of the fields in 
PARMLIST. The number that follows PARMLIST under the Width Shift category is 
the number of bytes in the whole structure. In this case, the structure has 
001CH (28 bytes). Under the category # Fields/Width, the number following 
PARMLIST is the number of fields in the structure. PARMLIST, as the 0004 
indicates, has four fields. 

The numbers under the category of Width/Shift that follow the field 
names of PARMLIST indicate the offset of the field into the structure. Thus, 
0000 indicates that BUFSIZE is the first field in the record PARMLIST. 

BUFSIZE is one byte long (subtract the offset of NAMESIZE from the offset of 
BUFSIZE to determine BUFSIZE's size), and begins with byte #0. The following 
is an example of a record listing of a symbol table. 



Name 

Width 

# fields 




Shift 

Width 

Mask 

Initial 

BAZ .... 


0008 

0003 



FLD1. . 


0006 

0002 

OOCO 

0040 

FLD2. • 


0003 

0003 

0038 

0000 

FLD3. . 


0000 

0003 

0007 

0003 

BAZ1. . . . 


000B 

0002 



BZ1 . . 


0003 

0008 

07F8 

0400 

BZ2 . . 

..... 

0000 

0003 

0007 

0002 


The names of the records are under BAZ and BAZ1. Following the record 
names are the sizes of the records in bits (eight in each case) and the numbe 
of fields in the record. There are three fields in BAZ and two fields in BAZ1 


Following the field names is the shift count. The shift count is the 
number of bits that the lowest bit in the field must move to the right to be 
positioned in the lowest bit of the record. For example, FLD1 has a shift 
count of six; that is, the lowest bit of FLD1 must move six places to the 
right to be in the 0 position. FLD2 has a shift count of three because the 
lowest bit in FLD2 has to move three bits to the right to be positioned in the 
lowest bit of the record. The lowest bit in FLD3 already occupies the lowest 
bit position in the record. 

The next group of numbers under #Fields/Width tells how many bits are in 
the field. For example, FLD1 has 2 bits, while FLD2 has three bits, and FLD3 
has three bits. 
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Next to # Fields/Width is Mask. The mask value tells the maximum amount 
field is worth if all the bits are set (if they are all l's instead of 
). For example, BAZ is composed of three fields. The first field, FLD1, 
cupies the highest two bits whose combined worth is 192 (2**7 + 2**6) if 
both bits are set. FLD2 is composed of three bits, occupying the positions 3, 
4, and 5; their total worth is 56 (2**5 + 2**4 + 2**3) if all the bits are 
set. FLD3 occupies the three lowest bits in positions 0, 1, and 2 whose worth 
is 7 (2**2 + 2**1 + 2**0) if all the bits are set. This total worth is called 
the mask. The following diagram illustrates the shift count and mask of FLD1, 
FLD2, and FLD3 of BAZ. 


SHIFTCOUNT - 6 SHIFTCOUNT - 3 



_ 1_1 


FIELD 1 

FIELD 2 

FIELD 3 1 


<4_1C 



mm 


-9 ^ 

^ 1« 

(2 7 - 128 

_ 1 

h 2«-64) 

ISnftfUi 


f P 

+ 2 ' - 2 + 2°~ 1) 

_ 1 _ 


7 6 5 4 3 2 1 0 

Figure 10-1. The Shift Count and Mask of a Record 


The last column is Initial. Initial specifies the initial value that 
you gave to the field when you named it, if any. For example, FLD1 is 
initially worth 40 hexadecimal, while FLD2 is 0. 


10.3.3 The Listing of Segments and Groups 


The third category listed in the symbol table is segments and groups. Groups 
include multiple segments combined so that the assembler addresses all of the 
separate segments from one base address. Segments that are not part of a 
group have individual base addresses. The following list includes both 
segments and groups. 
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Name Size align combine class 


AAAXQQ. 0000 WORD NONE * CODE * 

DGROUP. GROUP 

DATA. 0024 WORD PUBLIC ‘DATA’ 

STACK. 0014 WORD STACK ’STACK* 

CONST. ...... 0000 WORD PUBLIC *CONST* 

HEAP. 0000 WORD PUBLIC * MEMORY* 

MEMORY. 0000 WORD PUBLIC 'MEMORY* 

ENTXCM. 0037 WORD NONE * CODE * 

MAINSTARTUP. 007E PARA NONE 'MEMORY* 


In the previous example, GROUP appears in the size column next to a 
group name. Segments that are part of a group are indented under the group 
name. Segments that are not part of a group are not indented. There are 
three segments: AAAXQQ, ENTXCM, and MAINSTARTUP. There is also one group, 
DGROUP, composed of five segments: DATA, STACK, CONST, HEAP, and MEMORY. 

Next to the name of the segment or group is the Size column that 
indicates the number of bytes the segment occupies. For example, AAAXQQ does 
not occupy any bytes while ENTXCM occupies 37H bytes. 

The column to the right of Size is align. This column indicates the 
type of boundary on which a segment begins. There are four types of 
boundaries, defined as follows._ 

PAGE The address begins on a 256 byte boundary, the last two digits cl 
the hexadecimal number being 00: XXX00. ^ 

PARA The address begins on a boundary evenly divisible by 16, the last 
digit of the hexadecimal number being 0: XXXX0. 

WORD The address begins on an even numbered boundary, the last bit of 
the low byte being 0. 

BYTE The address can begin anywhere. 

In the previous example, most of the segments begin on WORD boundaries. 
MAINSTARTUP, however, begins on a PARA boundary. If you want to know more 
about these attributes, refer to Section 6.2, Combining Segments. 

There are five possible combine types you can declare in the source 
program: none, public, stack, common, and memory. They are defined as 
follows. 
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NONE 

The processor loads the segments separately and they remain 
separate entities (each private segment has its own base address). 

PUBLIC 

The processor loads public segments of the same name and class 
next to each other, and they use one base address. The offset is 
from the first to the last segment loaded. 

STACK 

The processor loads stack segments of the same name and class 
next to each other, and they use one base address. The offset is 
from the first to the last segment loaded. The stack pointer is 
set to the first address of the first stack segment 

MEMORY 

The processor loads memory segments of the same and class next to 
each other, and they use one base address. The offset is from 
the first to the last segment loaded. 

COMMON 

The processor loads common segments of the same name and class so 
that they overlap one another. There is one base address for all 
common segments of the same name and the length of the contnon 
area is the length of the longest segment. 

In the previous example, AAAXQQ, ENTXCM, and MAINSTARTUP are loaded 


separately, while DATA, STACK, CONST, HEAP, and MEMORY are loaded next to 
other segments of the same name and class. 

k The Linker loads segments by declared class name. It loads all the 
pegroents that belong to the first class it encounters together with the other 
segments of that class, .and then all the segments that belong to the next 
class it encounters, and so on, until it loads all the segments. In the 
previous example, the Linker loads the two 'CODE' segments first; the 'STACK 1 
segment second; the 'CONST' segment third; and the three 'MEMORY' segments 
last. 


10.3.4 The Listing of Symbols 


The last category listed in the symbol table is symbols. The table is divided 
into two parts: those symbols formed through the EQU or = directives and 
those that are not. The symbols formed through the EQU or = directive appear 
in the following example. 


Symbols: 



Name 

Type 

Value 

VAR1 .... 

. Number 

0005 

VAR2 .... 

. . Text 

1.234 

VAR3 .... 

. . Number 

0008 

|tfAR4 .... 

. . Alias 

VAR1 

§AR5 .... 

. . Text 

5[PB] 

*AR6 .... 

. . Opcode 



Attr 
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All of the above symbols were defined through the use of either the EQU 
or the = directive. The entries under type, number, text, alias, and opcode 
expres s the value of the symbols. These expressions are defined as follows 

Number A constant numeric value 


Opcode 



An instruction mnemonic, such as: 
VAR1 EQU ADD 


The substitution of one symbolic name for another, such as: 
VAR1 EQU VAR2 


Text The "text" the symbol represents (any other operand to an EQU 

directive that does not fit into one of the other three 
categories), such as: 

VAR3 EQU 'WOW' 

VAR4 EQU DS:8[BX] 

VAR5 EQU 1.234 

In the previous listing, VAR1 and VAR3 fall under the Number category 
and are worth 5 and 8, respectively. VAR2 and VAR5 with the values 1.234 and 
5[BP] [DI], respectively, fall under the category of Text. VAR4 is an alias 
for another variable, VAR1, while VAR6 is in the opcode category. 

The second part of the symbol table, presenting the symbols not defined 
by the EQU or = directives, follows. 

Symbols: 


Name 


Type 

Value 

BEGLHQQ . 


. L WORD 

0012 

BEGOQQ. . 


. L FAR 

0000 

BEG5CQQ. . 


. F PROC 

0000 

CESXQQ. . 


. L WORD 

0022 

CLNBQQ. . 


•. L WORD 

0001E 

DOSXQQ. . 


. F PROC 

001E 

ENDOQQ. . 


. L FAR 

0000 

HEAPBEG . 


. BYTE 

0000 

HEAPLOW . 


. BYTE 

0000 

RESEQQ. . 


. L WORD 

0010 

SMLSTK. . 


. L NEAR 

001C 


Attr 


DATA Global 
External 

MAIN Global Length=006E 
DATA Global 
DATA Global 

ENTXCM Global Length = 0019 
External 

STACK 

HEAP 

DATA Global 
MAIN 


Under the type category, six symbols can occur. They are the following. 
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L 

A label 

F 

Far, accessed by segment and offset 

N 

Near, accessed by offset from same segment 

PROC 

A procedure 

WORD 

A word in length 

BYTE 

A byte in length 


The type for BEGLHQQ, the first entry, is a label one word long. SMLSTK is a 
label that can be accessed by a NEAR JMP or CALL; and BEGOQQ is a label that 
must be accessed via a FAR JMP or CALL. 

In the value category are the addresses that the symbol represents. 

Thus, BEGLHQQ is located at 12H, while ENDOQQ is at 0. 

'The ATTR column shows the segment of the symbol. If the segment is not 
known, the ATTR column is blank. In the above symbol table, BEGLHQQ belongs 
to the DATA segment and HEAPBEG belongs to the STACK segment, but the segment 
to which HEAPLOW belongs is not known. 

Next to the segment name, the words Global or External may appear. The 
assembler distinguishes between the global and the external names. If the 
mame is neither global nor external, this column is blank. BEHLHQQ is global 
Prnile BEGOQQ is external, for example. HEAPBEG is neither global nor external. 

The last entry in the symbol table belongs only to procedures. It takes 
the following syntax. 

Length = nnn 

The length tells the size of procedures in bytes. There are two such entries 
above. The length of BEGXQQ is 006EH, while the length of DOSYQQ is 19H. 
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CHAPTER 11 
ERROR MESSAGES 


The error messages help you debug your program. There are three types of 
error messages: those produced by the assembler, I/O handler errors, and 
runtime errors. The assembler picks up errors in referencing and definition 
during assembiy. For example, an undefined variable, a variable defined as 
two different types, and the illegal use of registers are errors for which the 
assembler sends out messages. 6 


The faulty use of input and output devices cause I/O handler errors, 
or example, trying to access a file that is nonexistent or already in use or 
trying to print your file on a nonexistent device causes an I/O handler 
message. Runtime errors occur as your program is being executed. There are 
only two runtime errors: Out of Memory and Internal Error. 


L. 1 


ASSEMBLER ERROR MESSAGES 


When the assembler encounters an error, it sends out an error message to help 
you debug your program. The message occurs within the listing file. In 
addition, the assembler provides a summary of all errors at the end of the 
listing file. 


1 

Error- 

2 

0000 
0000 
0001 
0002 


NAME PROG 1 

1:Extra characters on line 

ASSUME DS:ABC, CS: ACD 
ABC SEGMENT 

05 VAR1 DB 5 

03 VAR2 DB 3 

ABC ENDS 
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8 

0000 


ACD SEGMENT 



9 

0000 

B8 -R 

START: 

MOV AX, 

ABC 

10 

0003 

8E D8 


MOV DS, 

AX 

11 

0005 

A1 0000 R 


MOV AX, 

VARl 

Error 

— 

31:Operand types 

must match 



12 

0008 

8B IE 0001 R 


MOV BX, 

VAR2 

Error 

— 

31:Operand types 

must match 



13 

oooc 

03 C3 


ADD AX, 

BX 

14 

000E 


ACD ENDS 



15 



END START 




In the program above, three errors occur, but two errors are of the same 
type, type 31. The name of the program, PROG 1, has an extra space in it.... 
Therefore, the message "Extra characters on line" indicates that the space is 
superfluous. By deleting the space and writing PR0G1, you eliminate the error. 

The second error is caused because the operands VAR1 and VAR2 are 
defined as bytes in the ABC SEGMENT and are moved into word registers. You 
can correct this mistake by making the variable size consistent with the 
register size. 

MOV AL, VAR1 
MOV BL, VAR2 
OR 

VARl DW 
VAR2 DW 
OR 

MOV AX, WORD PTR VARl 
MOV BX, WORD PTR VARl 

The following table gives the code number of the error message, the message in 
alphabetical order, and the cause of the error. > - 


Code Message Error 

23 Already defined locally Attempt to define previously defined 

local symbol as EXTERNAL. 

7 Already had ELSE clause ELSE clause defined within an existing 

ELSE clause when nesting is not legal. 

46 Already have base register Address given double base. 
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Code 

Message 

Error 

47 

Already have index register 

Address given double index. 

0 

Block nesting error 

Nested procedures, segments, 
structures, macros, IRC, IRP, or REPT 
are not properly terminated; they need 
an end statement. 

58 

Byte register is illegal 

Illegal use of one of byte registers. 

67 

Can't override ES segment 

Illegal attempt to override ES segment. 

68 

Can't reach with segment reg 

Variable out of range due to lack of 
ASSUME statement. 

70 

Can't use EVEN on BYTE 
segment 

Illegal use of EVEN directive with 
segment declared to be byte boundary. 

83 

Circular chain of EQU 
aliases 

An alias EQU eventually points to 
itself. 

42 

Constant was expected 

Assembler expects constant and finds 
something else. 

59 

CS register illegal usage 

Attempt to use CS register illegally. 

78 

Directive illegal in STRUC 

Illegal statement within STRUC block 
when only Define directives or 
comments preceded by semicolon are 
permitted. 

29 

Division by 0 or overflow 

Expression is given that results in a 
divide by 0. 

74 

DUP is too large for linker 

Nesting of DUP's is such that too 
large a record is created for the 

Linker. 
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Code Message 

1 Extra characters on line 

80 Field cannot be overridden 

71 Forward needs override 

17 Forward reference is illegal 

55 Illegal register value 

57 Illegal size for item 

32 Illegal use of external 

49 Illegal use of register 

72 Illegal value for DUP count 

52 Improper operand type 

61 Improper use of segment reg 

54 Index displ. must be 

constant 

65 Label can't have segment 

override 

38 Left operand must have 

segment 

76 More values than defined 

45 Must be associated with 

code 


Error 

Characters other than those needed tj 
define the instruction are received. 

Attempt to give a value to a field 
that cannot be overridden in a STRUC 
initialization statement. 


Attempt to forward reference something 
that must be defined in pass 1. 

Register value specified does not fit 
into 3 bit "reg" field; it is greater 
than 7. . . 

Illegal size of referenced item. 

Attempt to use external directive in 
an illegal manner. 

Attempt to use register with an 
instruction where no such instruction 
is possible. 

Attempt to use DUP when it is not a 
positive, nonzero constant. 

Attempt to use operand illegally 
results in no generation of op code. 

Illegal specification of segment 
register. 

Attempt to use variable as 
displacement value. 

Attempt to use segment override 
illegally. 

Attempt to use something in right 
operand that requires a segment in the 
left operand which is absent. 

Allocation of too many fields in REC 
or STRUC. 

Attempt to use data related item 
where code item is expected. 


Message is not currently used. 
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Code Message 

44 Must be associated with 

data 

60 Must be AX or AL 

48 Must be index or base 
register 

13 Must be declared in pass 1 
69 Must be in segment block 

33 Must be record field name 

34 Must be record or field name 

18 Must be register 

20 Must be segment or group 

37 Must be structure field 

name 

22 Must be symbol type 

36 Must be var, label or 

constant 

66 Must have opcode after 

prefix 

64 Near JMP/CALL to different 

CS 

56 No immediate mode 


Error 

Attempt to use code related item where 
data related item is expected. 

Attempt to use register other than AX 
or AL when only these are legal. 

Attempt to put other than index or 
base register in square brackets [ J 
when only index or base are legal. 

Assembler expecting constant value, 
but got another value. 

Attempt to generate code outside of a 
segment. 

Assembler expecting record field name, 
but another value is specified. 

Assembler expecting a record or field 
name, but another value is specified. 

Assembler expecting register as an 
operand, but another value is 
specified. 

Assembler expecting segment or group, 
but another value is specified. 

Assembler expecting structure field 
name, but another value is specified. 

Assembler expecting WORD, DW, QW, BYTE 
or TB but another value is specified* 

Assembler expecting a variable, label, 
or constant, but another value is 
specified. 

Attempt to use one of prefix 
instructions without specifying any op 
code after it. 

Attempt to do NEAR jump or call to 
location in different CS ASSUME. 

Attempt to use immediate mode with op 
code that cannot accept immediate mode. 
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Code 

Message 

Error 

62 

No or unreachable CS 

Attempt to jump to label that is out 
of reach. 

41 

Normal type operand 
expected 

Assembler expecting a variable label, 
but either STRUCT, FIELDS, NAMES, 

BYTE, WORD, or DW is specified. 

8 

Not in conditional 
block 

Specification of an ENDIF or ELSE 
without an active conditional assembly 
directive. 

25 

Not proper align/combine 
type 

SEGMENT parameters are incorrect. 

39 

One operand must be const 

Illegal use of addition operator. 

77 

Only initialize list legal 

Attempt to use STRUC name without 
angle brackets. 

63 

Operand combination illegal 

Specification of two-operand 
instruction where combination 
specified is illegal. 

40 

Operands must be same or 1 
abs 

Illegal use of subtraction operator. 

43 

Operand must have segment 

Illegal use of SEG directive. 

35 

Operand must have size 

Assembler expecting operand to have a 
size, but it is absent. 

51 

Operand not in IP segment 

Assembler cannot access operand 
because it is not in the current CS 
segment. 

31 

Operand types must match 

Assembler needs matching arguments, 
but different kinds or sizes are 
specified. 

27 

Operand was expected 

Assembler expecting operand, but it is 
missing. 

28 

Operator was expected 

Assembler expecting operator, but it 
is missing. 
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Code Message 

81 Override is of wrong type 

79 Override with DUP is 

illegal 

6 Phase error between passes 

4 Redefinition of symbol 

26 Reference to mult defined 

2 Register already defined 

82 Register can’t be forward 
ref 

53 Relative jump out of range 

24 Segment parameters are 

changed 

30 Shift count is negative 

12 Should have been group 

name 

15 Symbol already different 

kind 

73 Symbol already external 

21 Symbol has no segment 

5 Symbol is multi-defined 


Error 

Assembler expecting certain type of 
override in STRUG initialization 
statement, but an other type is 
specified. 

Illegal use of DUP in override in a 
STRUG initialization statement. 

An ambiguous instruction directive 
causes location of label to change 
value between pass 1 and pass 2 of 
assembler. 

The symbol redefined so that its 
values on pass one and pass two are 
inconsistent. 

Instruction references something that 
has been defined more than once. 

Assembler has internal logic errors. 

You cannot use a forward reference 
with a register name. 

The jump is not within 127 bytes of 
current instruction. 

Arguments to SEGMENT not identical 
with those stated the first time this 
segment is used. 

Shift expression generates negative 
shift count. 

Assembler expecting group name, but 
another value is specified. 

Attempt to define symbol differently 
from previous definition. 

Attempt to define symbol as local that 
already is defined as external. 

Attempt to use variable with SEG with 
no defined segment. 

Symbol was already defined earlier in 
same program. 
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Code Message Error 

16 Symbol is reserved word Illegal attempt to use assembler 

reserved word. 


9 Symbol not defined 

14 Symbol type usage illegal 

10 Syntax error 

11 Type illegal in context 

3 Unknown symbol type 

75 Usage of ? (indeterminate) 
bad 

50 Value is out of range 

19 Wrong type of register 

At the end of the symbol table i 
errors in the program appears. The er 


Attempt to use symbol with no 
definition. 

Illegal use of PUBLIC symbol. 

Syntax of statement does not match any 
recognizable syntax. 

Attempt to use illegal type. 

Attempt to use symbol that has 
something unrecognizable in type field 

Improper use of 

Value is too large for expected use. 

Assembler expects one type of 
directive or instruction, but another 
one is specified. 

the listing file, a summary of all th 
>r summary for PR0G1 is as follows. 


Warning Severe 
Errors Errors 
1 2 


11.2 I/O HANDLER ERRORS 


The second type of error message that appears in the list table is the I/O 
handler message. The I/O handlers, also known as device drivers, are small 
programs that communicate with the input and output devices. The error 
messages generated by the I/O handlers appear in a different format from those 
generated by the assembler. The format is as follows. 

MASM Error — error message 
in: filename 
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The second line of the message in filename states the name of the file 
t is being handled when the error occurs. The following is a list of the 
ror messages. 


Code 

Message 

114 

Data Format 

108 

Device full 

102 

Device name 

105 

Device offline 

112 

File in use 

107 

File name 

110 

File not found 

113 

File not open 

104 

File system 

101 

Hard data 

115 

Line too long 

106 

Lost file 

103 

Operation 

111 

Protected file 

109 

Unknown device 


11.3 RUNTIME ERRORS 




F processor puts out runtime errors when the program is 
iere are only two runtime errors, and neither one uses a 


being executed, 
numerical code. 


An Internal error is usually caused by an arithmetic check. When this 
code occurs, call the Wang Professional Computer Assistance Center at 
1-800-343-1098. The Out of Memory error is caused when the source is too big 
or too many labels are in the symbol table. 
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CHAPTER 12 

THE CROSS-REFERENCE FILE 


The assembler creates the cross-reference file, the file that the Wang PC CREF 
facility uses to create the cross-reference listing file. The assembler's 
product, the cross-reference file, is input into CREF. CREF creates the final 
product, a file that lists in alphabetical order the line numbers of all of 
the symbols used in your program as well as the line numbers on which the 
symbol is defined. 

CREF is a valuable tool in debugging your program. It can help you 
locate quickly all occurrences of any symbol by line number. In a long, 
multi-modular program, CREF provides you with a quick and easy way of checking 
symbols. 



CREATING A CROSS-REFERENCE FILE 


To create a cross-reference file, command the assembler to create a 
cross-reference file during assembly. You do this either by writing the name 
of your program into the fourth position in the series of file commands or by 
writing the name of your file after the fourth prompt. Both methods are 
demonstrated below. 


MASM PR0G1, PR0G1, PR0G1, PR0G1 
Cross reference [NUL.CRF]: 

In the first example, the last PR0G1 in the listing after MASM creates the 
cross-reference file, PR0G1.CRF. In the second example, you create a cross 
reference file by entering PR0G1 after the prompt as follows. 

Cross reference [NUL.CRF]: PR0G1 

The default of the cross-reference prompt is a null file. Therefore, you must 
answer the prompt if you wish to create a cross-reference file. .CRF is the 
default extension of the cross-reference file. It is legal to use another 
extension if you wish, however. 
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12.2 INVOKING CREF 


Once the assembler has created a cross-reference file, you must convert it to 
the cross-reference listing file with the default extension .REF. The CREF 
program accomplishes this. 

To invoke CREF, you can either list the names of the cross-reference 
file and the cross-reference listing file next to the command CREF or you can 
respond to individual prompts. 


12.2.1 Invoking CREF: Method One 


When you use method 1 to invoke the assembler, you list the cross-reference 
file and the cross-reference listing file next to the command CREF. The 
syntax of this method is as follows. 

CREF cross-reference file, cross-reference listing 

For example, the following command causes CREF to be loaded into memory, 
where it creates a cross-reference listing file. 

CREF PR0G1, PR0G1 

To select the default file name and the default extension for the 
cross-reference listing file, you can enter a semicolon after the 
cross-reference file name. Through the following command, CREF produces a 
cross-reference listing file, called PR0G1.REF, from the cross-reference file 
called PR0G1.CRF. 

CREF PR0G1; 

To give the listing file a different name, extension, or destination, 
simply specify these differences when entering the command line. The 
following command causes CREF to produce a cross-reference listing file named 
WORK.ARG, from the cross-reference file, named PR0G1, and to place it on the 
diskette in drive B. 

CREF PR0G1, B:WORK.ARG 


12.2.2 Invoking CREF; Method Two 


When you use Method Two to invoke the assembler, you respond to individual 
prompts. Begin by entering the command CREF from the DOS COMMAND PROCESSOR, 
choose OTHER from the System Menu, or pick CREF from the the Program 
Development Menu choice CREF. 

CREF 
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is loaded into memory and returns with the following two prompts 


Cross reference [.CRF]: 
Listing [erffile.REF]: 


one at a 


To the first prompt, enter the name of the cross-reference file produced 
by the assembler. If your file name has a different extension from the 
default, .CRF, enter it. Otherwise, the name of your file is sufficient. 


Cross reference [.CRF]: PR0G1 


To the second prompt, enter the name that you want the cross-reference 
listing file to have. If you want to use the default name, the name of your 
cross-reference file with the default .REF, press RETURN. In the first 
example below, you give the cross-reference listing file the name PR0G2.ART; 
in the second example, the processor gives it the default name, PR0G1.REF. 

Cross reference [.CRF]: PR0G2.ART 
Cross reference [.CRF]: RETURN 


want the listing file placed on a drive or device other than the 
default drive, specify the drive or device when entering your response to the 
prompt as follows. 



Cross reference [.CRF]: B:PR0G2.ART 
COMMAND CHARACTERS 


There are two command characters in CREF: the semicolon and the Control-C. 
Their functions can be summarized as follows. 


The semicolon (;) 

To select the default for the cross-reference 
listing file prompt, use the semicolon. 

CONTROL-C 

To exit from CREF and return to the system 
prompt, enter Control-C. 

SHIFT-CANCEL 

To exit from CREF and return to the system 
prompt, enter SHIFT and CANCEL. 

2ND -COMMAND-CANCEL 

To exit from CREF and reboot the system, enter 
2ND and COMMAND and CANCEL. 


When you enter a semicolon rather than a file name after the 
cross-reference file prompt, you choose the default. In the following 
example, CREF creates the file PR0G1.REF. 
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Cross reference [.CRF]: PR0G1 
Listing [erffile.REF]: ; 

If you make a mistake or otherwise wish to return to control level, 
press the CONTROL key at the same time as the C key. The following system 
prompt appears. 

CONTROL-C 

B: 


12.4 THE FORMAT OF THE CROSS-REFERENCE LISTING FILE 

The cross-reference listing file is an alphabetical list of all the symbols in 
your program. Next to the symbols is a list of all the line numbers in which 
the symbol occurs. A pound sign indicates on which line number the symbol is 
first defined. The following is an example of a cross-reference listing file. 

Symbol Cross Reference (# is definition) Cref-1 


AAAXQQ. 37# 38 

BEGHQQ. 83 84# 154 176 

BEGOQQ. 33 162 

BEHXQQ. 113 126# 164 223 

CESXQQ. 97 99# 129 

CLNEQQ 67 68# 

CODE. 37 182 

CONST. 104 104 104 110 

CRCXQQ. 93 94# 210 215 

CRDXQQ. 95 96# 216 

CSXEQQ. 65 66# 149 

CURHQQ. 85 86# 155 

DATA. 64# 64 155 

DGROUP. 110# 110 111 111 127 

DOSOFF. 98# 198 199 

DQXTQQ. 184 204# 219 
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2.5 ERROR MESSAGES 


When an error occurs, CREF aborts and control returns to the operating 
system. The following is the format of all error messages. 

Fatal I/O Error error number 
in File: filename 

The filename is the name of your file. 

The error number is the code number for the particular error. 

The following is a list of all errors, their code numbers and their 
cause, or what to do if the particular error occurs. 


Code 

Messaqe 

Cause or what to do 

101 

Hard data error 

Unrecoverable input or output due to 
disk damage. 

101 

Device name error 

Illegal device specification. 

103 

Internal error 

Report to the Wang Professional 
Computer Assistance Center at 
1-800-343-1098. 

104 

Internal error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

105 

Device offline 

Device not ready to accept data 
because device is inaccessible. For 
example, disk drive door could be 
open or no printer is attached. 

106 

Internal Error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

108 

Disk full 

The disk is full. To run program, 
delete some files. 
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Code 

Messaqe 

Cause or what to do 

110 

File not found 

Either the name submitted is 
incorrect or the file is not on the 
disk. 

111 

Disk is write protected 

Protection bit set so that file 
cannot be written. 

112 

Internal error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

113 

Internal error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

114 

Internal error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

115 

Internal error 

Report to Wang Professional Computer 
Assistance Center at 1-800-343-1098. 

THE FORMAT OF CREF 



The cross-reference file is made up of consecutive bytes in memory which store 
the name of each symbol, the line numbers on which references to the symbol 
occur, and the line number on which a definition of the symbol occurs. In 
addition, the cross-reference file contains some formatting information: the 
title, the page length and the line length. 

To create the cross-reference file, the assembler counts the lines of 
the program. It must note each reference to a symbol and each definition that 
occurs on an individual line. 

To create the cross-reference file, the assembler uses a series of 
r ambe rs each of which gives CREF some needed information to create the 
cross-reference listing file. The numbers and the information that they 
relate to CREF are as follows. 
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Number Symbolic Value 
01 Reference symbol 


02 Define symbol 


04 End of line 

05 End of file 


06 Title defined 


Meaning of Message and Rules 

On the following line, there is a 
reference to a symbol whose name 
follows in ASCII code. The name may be 
from 1 to 80 ASCII characters long. 
Additional characters are truncated. 

On the following line, there is a 
definition of a symbol whose name 
follows in ASCII code. The name may be 
from 1 to 80 ASCII characters long. 
Additional characters are truncated. 

Add one more line to the line count. 

No more processing is necessary. All 
symbols have been referenced. This 
symbol is followed by 1AH CONTROL-Z)and 
indicates the end of the file. 

The preceding ASCII characters compose 
the title. The title may be from 1 to 
80 characters long. Additional 
characters are truncated. The last 
title definition record encountered is 
used for the title; if no title 
definition record is encountered, the 
title line is left blank. 


page length/line length The first of the preceding two numbers 

represents page length; the second 
represents line length. These two 
values are the first two bytes of the 
file. The page length can be from 1 to 
155 lines; the page width can be from 
1 to 132 characters. The default page 
length is 58; the default page width is 
80. 


The following lines of numbers are part of a memory dump of the 
cross-reference file of PR0G4, a program whose listing file appears in Section 
10.2. In other words, if you could see into the memory of the computer, the 
first 9 lines of the cross-reference file of PR0G4 would appear as a sequence 
of bytes containing the following numbers. 


3A 50 07 04 04 02 48 45 41 50 42 45 47 04 04 04 
04 04 02 53 4B 54 4F 50 04 01 53 54 41 43 4B 04 
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The first number, 3A, tells the number of lines to be printed per page. 
3A in hexadecimal is equivalent to 58 in decimal notation. The page length 
for this document is therefore 58 lines. 

The second number, 50, refers to the number of characters per line. 50 
is the hexadecimal equivalent for 80 decimal. Therefore, the page width for 
the document is 80 characters. 

The third number, 07, is a kind of delimiter that tells CREF that the 
two preceding bytes define the page size. 

The fourth number, 04, is the symbol for the end of the line. CREF 
counts each 04 as a line counter. The first 04 is followed by a second one, 
indicating that CREF is to add two lines to the count. 

The next number, 02, informs CREF that the following symbol is defined 
on line three, the line that CREF is presently on. 

The numbers, 48, 45, 41, 50, 42, 45, and 47, are the ASCII equivalents 
of H, E, A, P, B, E, G. Together they spell the name of the symbol: HEAPBEG. 

The name of the symbol is followed by five 04*s, indicating that the 
assembler has found no symbolic names on the following five lines, and should 
add five to the counter. The 04’s are followed by an 02, indicating that on 
the eighth line, the assembler finds another symbol and its definition. The 
ASCII equivalent of SKTOP follows in the numbers 53, 4B, 54, 4F, and 50. An 
04 indicates the completion of that line. 

The next number, 01, indicates that the following code refers to a 
symbol. The numbers 53, 54, 41, 43, and 4B are the ASCII equivalent of that 
symbol: STACK. The last number on the line, 04, indicates the end of that 
line. Using this code, CREF creates a file: PROG4.REF:. PR0G4.REF lists 
each symbol, the line numbers on which it falls, and the line number on which 
it is defined. 
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ASCII CHARACTER CODES 


Dec 

_ Hex 

CHR 

Dec 

Hex 

CHR 

Dec 

Hec 

CHR 

000 

00H 

NUL 

043 

2BH 

+ 

086 

56H 

V 

001 

01H 

SOH 

044 

2CH 

9 

087 

57H 

w 

002 

02H 

STX 

045 

2DH 

- 

088 

58H 

X 

003 

03H 

ETX 

046 

2 EH 


089 

59H 

Y 

004 

04H 

EOT 

047 

2FH 

/ 

090 

5 AH 

z 

005 

05H 

ENQ 

048* 

30H 

0 

091 

5BH 

[ 

006 

06H 

ACK 

049 

31H 

1 

092 

5CH 

\ 

007 

07H 

BEL 

050 

32H 

2 

093 

SDH 

1 

008 

08H 

BS 

051 

33H 

3 

094 

5EH 

yv 

009 

09H 

HT 

052 

34H 

4 

095 

5FH 


010 

OAH 

LF 

053 

35H 

5 

096 

60H 

T 

Oil 

OBH 

VT 

054 

36H 

6 

097 

61H 

a 

012 

OCH 

FF 

055 

37H 

7 

098 

62H 

b 

013 

ODH 

CR 

056 

38H 

8 

099 

63H 

c 

014 

OEH 

SO 

057 

39H 

9 

100 

64H 

d 

015 

OFH 

SI 

058 

3 AH 

• 

101 

65H 

e 

016 

10H 

DLE 

059 

3BH 

7 

102 

66 H 

f 

017 

11H 

DC1 

060 

3CH 

< 

103 

67H 

g 

018 

12H 

DC2 

061 

3DH 

— 

104 

68 H 

h 

019 

13H 

DC3 

062 

3 EH 

> 

105 

69H 

i 

020 

14H 

DC4 

063 

3FH 

7 

106 

6 AH 

j 

021 

15H 

NAK 

064 

40H 

@ 

107 

6 BH 

k 

022 

16H 

SYN 

065 

41H 

A 

108 

6 CH 

1 

023 

17H 

ETB 

066 

42H 

B 

109 

61X1 

a 

024 

18H 

CAN 

067 

43H 

C 

110 

6 EH 

n 

025 

19H 

EM 

068 

44H 

D 

111 

6 FH 

o 

026 

1AH 

SUB 

069 

45H 

E 

112 

7 OH 

p 

027 

1BH 

ESCAPE 

070 

46H 

F 

113 

71H 

q 

028 

1CH 

FS 

071 

47H 

G 

114 

72H 

r 

029 

1DH 

GS 

072 

48H 

H 

115 

73H 

s 

030 

1EH 

RS 

073 

49H 

I 

116 

74H 

t 

031 

1FH 

US 

074 

4AH 

J 

117 

75H 

u 

032 

2 OH 

SPACE 

075 

4BH 

K 

118 

76H 

V 

033 

21H 

i 

076 

4CH 

L 

119 

77H 

V 

^ 034 

22H 

M 

077 

4DH 

M 

120 

78H 

z 

035 

23H 

# 

078 

4 EH 

N 

121 

79H 

y 

; )36 

24H 

$ 

079 

4FH 

0 

122 

7AH 

z 

^■Jo37 

25H 

% 

080 

SOH 

P 

123 

7BH 

f 


ASCII Character Codes 
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Dec 

Hex 

CHR 

Dec 

)38 

26H 

& 

081 

)39 

27H 

» 

082 

)40 

28H 

( 

083 

)41 

29H 

) 

084 

)42 

2 AH 

* 

085 


Hex 

CHR 

Dec 

Hec 

51H 

Q 

124 

7CH 

52H 

R 

125 

7DH 

53H 

S 

126 

7 EH 

54H 

T 

127 

7FH 

55H 

U 





Dec=Decimal, Hex=Hexadecimal (H), CHR=Character. 

!P=Line Feed, FF=Form Feed, CR=Carriage Return, DEL=Rubout 
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TABLE OF ASSEMBLER DIRECTIVES AND OPERATORS 


B.l MEMORY DIRECTIVES 


The ASSUME statement 


ASSUME segment register:segment name [,segment register:segment name. ] 
ASSUME NOTHING 

The data allocation statements 

name DB expression 
name DD expression 
name DQ expression 
name DT expression 
name DW expression 

Symbols and their values 

name EQU expression 
name = expression 

Symbols and their types 

EXTRN name:type [,name:type...] 

PUBLIC name [, name... ] 
name LABEL type 
name PROC [NEAR] 
name PROC [FAR] 

Numbers and their notation 

•RADIX expression 

Addressing directives 

EVEN 

ORG expression 


Table of Assembler Directives and Operators 


End statements 


SEGMENT 

ENDS 

STRUCT 



ENDS 

program 


END 

Other directives 


COMMENT delimiter text delimiter 
NAME module name 


B.2 MACRO DIRECTIVES 


ENDM 

EXITM 

IRP dummy, parameters in angle brackets 
IRPC dummy, string 
LOCAL parameter [,parameter...] 
name MACRO parameter [,parameter... ] 

PURGE macro-name 
REPT expression 

Special Macro Operators 


& (ampersand) - concantenation 

<text> (angle brackets - single literal) 

;; (double semicolons) - suppress comment 

! (exclamation point) - next character literal 
% (percent sign) - convert expression to number 
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CONDITIONAL DIRECTIVES 


ELSE 
END IF 

IF expression 
IFB argument 
IFDEF symbol 

IFDIF argument 1, argument 2 

IFE expression 

IFIDN argumentl,argument2 

IFNB argument 

IFNDEF symbol 

IF1 

IF2 


B.4 LISTING DIRECTIVES 


.CREF 

.LALL 

•LFCOND 

.LIST 

%OUT text 

PAGE expression 

.SALL 

.SFCOND 

SUBTTL text 

.TFCOND 

TITLE text 

.XALL 

.XCREF 

.XLIST 


B.5 ATTRIBUTE OPERATORS 


a 


Override Operators 
Pointer (PTR) 

attribute PTR expression 
Segment Override (:) (colon) 

segment-register: address-expression 
segment-name:address-expression 
group-name:address-expression 
SHORT 

SHORT label 

THIS 

THIS distance 
| THIS type 
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Value Returning Operators 


SEG 

SEG label 
SEG variable 
OFFSET 

OFFSET label 
OFFSET variable 

TYPE 

TYPE label 
TYPE variable 
.TYPE 

.TYPE variable 
LENGTH 

LENGTH variable 

SIZE 

SIZE variable 

Record Specific Operators 

Shift-count - (Record fieldname) 
record-fie1dname 

MASK 

MASK record-fieldname 
WIDTH 

WIDTH record-fieldname 
WIDTH record 



B.6 PRECEDENCE OF OPERATORS 


All operators in a single item have the same precedence, regardless of the 
order listed within the item. Spacing and line breaks are used for visual 
clarity, not to indicate functional relations. 

1. LENGTH, SIZE, WIDTH, MASK 
Entries inside: parenthesis ( ) 

angle brackets < > 
square brackets [ ] 

Structure variable operand: <variable>.<field> 

2. Segment override operator: colon (:) 

3. PTR, OFFSET, SEG, TYPE, THIS 

4. HIGH, LOW 

5. *, /, MOD, SHL, SHR 

6 . +, - (both unary and binary) 
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7. EQ, NE, LT, LE, GT, GE 

8 . Logical NOT 

9. Logical AND 

10. Logical OR, XOR 

11. SHORT,.TYPE 
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APPENDIX C 
ERROR MESSAGES 


Code Message 

0 Block nesting error 

1 Extra characters on line 

2 Register already defined 

3 Unknown symbol type 

4 Redefinition of symbol 

5 Symbol is multi-defined 

6 Phase error between passes 

7 Already had ELSE clause 

8 Not in conditional block 

9 Symbol not defined 

10 Syntax error 

11 Type illegal in context 

12 Should have been group name 

13 Must be declared in pass 1 

14 Symbol type usage illegal 

15 Symbol already different kind 

16 Symbol is reserved word 

17 Forward reference is illegal 

18 Must be register 

19 Wrong type of register 

20 Must be segment or group 

21 Symbol has no segment 

22 Must be symbol type 

23 Already defined locally 

24 Segment parameters are changed 

25 Not proper align/combine type 

26 Reference to mult defined 

27 Operand was expected 

28 Operator was expected 

29 Division by 0 or overflow 

30 Shift count is negative 

31 Operand types must match 

32 Illegal use of external 

33 Must be record field name 

34 Must be record or field name 

35 Operand must have size 

36 Must be var, label or constant 
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Code Message 

37 Must be structure field name 

38 Left operand must have segment 

39 One operand must be const 

40 Operands must be same or 1 abs 

41 Normal type operand expected 

42 Constant was expected 

43 Operand must have segment 

44 Must be associated with data 

45 Must be associated with code 

46 Already have base register 

47 Already have index register 

48 Must be index or base register 

49 Illegal use of register 

50 Value is out of range 

51 Operand not in IP segment 

52 Improper operand type 

53 Relative jump out of range 

54 Index displ. must be constant 

55 Illegal register value 

56 No immediate mode 

57 Illegal size for item 

58 Byte register is illegal 

59 CS register illegal usage 

60 Must be AX or AL 

61 Improper use of segment reg 

62 No or unreachable CS 

63 Operand combination illegal 

64 Near JMP/CALL to different CS 

65 Label can't have seg. override 

66 Must have opcode after prefix 

67 Can't override ES segment 

68 Can’t reach with segment reg 

69 Must be in segment block 

70 Can’t use EVEN on BYTE segment 

71 Forward needs override 

72 Illegal value for DUP' count 

73 Symbol already external 

74 DUP is too large for linker 

75 Usage of ? inate) bad (Code 75) 

76 More values than defined with 

77 Only initialize list legal 

78 Directive illegal in STRUG 

79 Override with DUP is illegal 

80 Field cannot be overridden 

81 Override is of wrong type 

82 Register can't be forward ref 

83 Circular chain of EQU aliases 


Error Messages 


Code 


Message 


101 Hard data 

102 Device name 

103 Operation 

104 File system 

105 Device offline 

106 Lost file 

107 File name 

108 Device full 

109 Unknown device 

110 File not found 

111 Protected file 

112 File in use 

113 File not open 

114 Data format 

115 Line too long 
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AAA AAA (no operands) ASCII Adjust for Addition 

AAA performs a correction of the 
result in AL of adding two 
unpacked decimal operands yielding 
an unpacked decimal sum. 


Operands 

Bytes 

/Example 

Flags 


none 

1 

AAA 

AF=A 

PF=U 




CF=A 

SF=U 




0F=U 

ZF=U 


AAD AAD (no operands) ASCII Adjust for Division 

AAD performs an adjustment of the 
dividend in AL before a subsequent 
instruction divides two unpacked 
decimal operands, so that the 
result of the division will be an 
unpacked decimal quotient. 


Operands 

Bytes 

Example 

Flags 

none 

2 

AAD 

AF=U SF=A 
CF=U ZF=A 
0F=U 

PF=A 
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AAM AAM (no operands) ASCII Adjust for Multiply 

AAM performs a correction of the 
result in AX of multiplying two 
unpacked decimal operands yielding 
an unpacked decimal product. 


Operands 

Bytes 

Example 

Flags 


none 

1 

AAM 

AF=U 

PF=A 




CF=U 

SF=A 




OF=U 

ZF=A 

AAS 

AAS (no operands) 

ASCII 

Adjust for Subtraction. 



AAS performs a correction of the 
result in the AL register of 
subtracting two unpacked decimal 
operands, yielding an unpacked 
decimal difference. 


Operands 

Bytes 

Example 

Flags 


none 

1 

AAS 

AF=A 

PF=U 




CF=A 

SF=U 




0F=U 

ZF=IL 


ADC ADC destination . Add with Carry 

source 

ADC performs an addition of the 
two operands, adds one if the CF 
flag is set, and returns the 
result to the destination 
(left-most operands). 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

ADC AX, SI 

AF=A 

PF=A 

register, memory 

2-4 

ADC DX, BETA [SI] 

CF=A 

SF^A 

memory, register 

2-4 

ADC ALPHA [BXJ [SI], DI 

0F=A 

ZF=A 

register, immediate 

3-4 

ADC BX, 256 



memory, immediate 

3-6 

ADC GAMMA, 30H 



accumulator, immediate 

2-3 

ADC AL, 5 
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ADD ADD destination ,, Addition 

source 

ADD performs an addition of the 
two source operands and returns 
the result to the destination 
operands* 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

ADD CX, DX 

AF=A 

PF=A 

register, memory 

2-4 

ADD DI, [BX]. ALPHA 

CF=A 

SF=A 

memory, register 

2-4 

ADD TEMP, CL 

0F=A 

ZF=A 

register, immediate 

3-4 

ADD CL, 2 



memory, immediate 

3-6 

ADD ALPHA, 2 



accumulator, immediate 

2-3 

ADD AX, 200 




AND AND destination . Logical AND 

source 

AND performs the bitwise logical 
conjunction of the twcf source 
operands and returns t$ie result to 
one of the operands. V 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

AND AL, BL 

AF=U 

PF=A 

register, memory 

2-4 

AND CX, FLAG WORD 

CF=0 

SF=A 

memory, register 

2-4 

AND ASCII [DI],AL 

OF=0 

ZF=A 

register, immediate 

3-4 

AND CX, OFOH 



memory, immediate 

3-6 

AND BETA, 01H 



accumulator, immediate 

2-3 

AND AX, 01010000B 




CALL 

CALL target 

Call a Procedure 



CALL pushes the offset address of 
the next instruction onto the 
stack (in the case of an inter¬ 
segment call the CS segment 
register is pushed first) and then 
transfers control to the target 
operand. 

Operands 

Bytes 

Example p Flags 

near-proc 

3 

. 

CALL NEAR PROC % none 

far-proc 

5 

CALL FAR PROC vi 

memptr 16 

2-4 

CALL PROC TABLE [SI] 

regptr 16 

2 

CALL AX 

memptr 32 

k_ 

2-4 

CALL [BX].TASK [SI] 
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CBW 

(no operands) 


Convert Byte to Word 





CBW performs a sign extension of 
the AL register into the AH 
register. 

Operands 


Bytes 

Example Flags 

none 


1 

CBW 

none 

CLC 

CLC 

(no operands) 


Clear Carry Flag 





CLC clears the CF flag. 

Operands 


Bytes 

Example Flags 

none 


1 

CLC 

CF=0 

CLD 

CLD 

(no operands) 


Clear Direction Flag 





CLD clears the DF flag, causing 
the string operations to auto¬ 
increment the operand pointers. 

Operands 


Bytes 

Example Flags 

none 


1 

CLD 

DF=0 

CLI 

CLI 

(no operands) 


Clear Interrupt Flag (Disable) 





CLI clears the IF flag, disabling 
maskable external interrupts, 
which appear on the INTR line of 
the processor. (Non-maskable 
interrupts, which appear on the 

NMI line, are not disabled.) 

Operands 


Bytes 

Example Flags • 

none 


1 

CLI 

DF=0 

CMC 

CMC 

(no operands) 


Complement Carry Flag 





CMC complements the CF flag. 

Operands 


Bytes 

Example Flags 

none 


1 

CMC 

CTst i 



The 8086 Instruction Set 


CMP CMP destination . Compare Two Operands 

source 

CMP performs a subtraction of the 
two operands causing the flags to 
be affected but does not return 
the result. 

The source (right-most) operand 
must be of the same type (byte or 
word) as the destination operand. 
The only exception for CMP is 
comparing an immediate-data byte 
with a memory word. 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

CMP BX CX 

AF=A 

PF=A 

register, memory 

2-4 

CMP DH, ALPHA 

CF=A 

SF=A 

memory, register 

2-4 

CMP [BP +2], SI 

0F=A 

ZF=A 

register, immediate 

3-4 

CMP BL, 02H 



memory, immediate 

3-6 

CMP [BX].RADAR [DI], 3420H 



accumulator, immediate 

2-3 

CMP AL, 00010000B 




CMPS 

CMPSB 

CMPSW 


CMPS dest-string , 
source-string 
or 

CMPSB (no operands) 
or 

CMPSW (no operands) 


Compare Byte or Word String 

CMPS subtracts the type (or word) 
operand addressed by DI from the 
operand addressed by SI and 
affects the flags but does not 
return the result. As a repeated 
operation, this provides for 
comparing two strings. With the 
appropriate repeat prefix, it is 
possible to determine after which 
string element the two strings 
become unequal, thereby 
establishing an ordering between 
the strings. 

Note that the operand indexed by 
DI is the right-most operand in 
this instruction, and that this 
operand is addressed using the ES 
register only. This default 
CANNOT be overridden. 


Operands 

Bytes 

Example 

- Flags 


dest-string. 

1 

CMPS BUFFI, BUFF2 

AF=A 

PF=A 

source-string 



CF=A 

SF=A 

(repeat) dest-string. 

1 

REPE CMPS ID, KEY 

0F=A 

ZF=A 


source string 
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CWD CWD (no operands) Convert Word to Doubleword 

CWD performs a sign extension of 
the AX register into the DX 
register. See the DIV instruction 
in this chapter. 

Operands Bytes Example Flags 

none 1 CWD none 


DAA DAA (no operands) Decimal Adjust for Addition 

DAA performs a correction of the 
result in AL of adding two packed 
decimal operands, yielding a 
packed decimal sum. 


Operands 

Bytes 

Example 

Flags 


none 

1 

DAA 

AF=A 

PF=A 



CF=A 

SF=A 




OF=A 

ZF=A 


DAS DAS (no operands) Decimal Adjust for Subtraction 

DAS performs a correction of the 
result in the AL register of 
subtracting two packed decimal 




operands, yielding a packed 




decimal difference. 



Operands 

Bytes 

Example 

Flags 


none 

1 

DAS 

AF=A 

PF=A 




CF=A 

SF=A 




OF=U 

ZF-A 

DEC 

DEC destination 

Decrement Destination by One 




DEC performs a subtraction of 

1 



from the operand and returns the 



result to that operand. 



Operands 

Bytes 

Example 

Flags 


regl 6 

1 

DEC AX 

AF=A 

SF=A 

reg 8 

2 

DEC AL 

OF=A 

ZF=A 

memory 

2-4 

DEC ARRAY [SI] 

PF=A 

-1 
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DXV 


DIV source 


Division, Unsigned 


Operands 

reg8 

reg!6 

mem8 

meml6 


ESC 


Operands 

immediate, 

immediate. 


DIV performs an unsigned division 
of the double-length NUMR operand, 
contained in the accumulator and 
its extension (AL and AH for 8-bit 
operation, or AX and DX for 16-bit 
operation) by the DIVR operand, 
contained in the specified source 
operand. It returns the 
single-length quotient (QUO 
Operand) to the accumulator (AL or 
AX), and returns the single-length 
remainder (the REM operand) to the 
accumulator extension (AH for 
8 -bit operation or DC for 16-bit 
operation). If the quotient is 
greater than MAX (as when division 
by zero is attempted), QUO and REM 
are undefined, and a type 0 
interrupt is generated. Flags are 
undefined in any DIV operation. 



Non-integral quotients 
truncated to integers. 

are 


Bytes 

Example 

Flags 


2 

DIV CL 

AF=U 

PF=U 

2 

DIV BX 

CF=U 

SF=U 

i i 
rvj cn 

DIV ALPHA 

DIV TABLE [SI] 

OF=U 

ZF=U 


ESC external-opcode , Escape 
source 

The ESC instruction provides a 
mechanism by which other 
processors may receive their 
instructions from the instruction 
stream and make use of the 
addressing modes. The processor 
does no operation for the ESC 
instruction other than to access a 
memory operand and place it on the 
bus. 

Bytes Example Flags 

memory 2-4 ESC 6, ARRAY [SI] none 

register 2 ESC 20,AL 
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HLT HLX (no operands) Halt 

The HLT instruction causes the 
processor to enter its halt state. 

Operands Bytes Example Flags 

none 1 HLT none 


IDIV IDIV source Integer Division, Signed 

IDIV performs a signed division of 
the double-length NUMR operand, 
contained in the accumulator and 
its extension (AL and AH for 8-bit 
operation, or AX and DX for 16-bit 
operation) by the DIVR operand, 
contained in the specified source 
operand. It returns the 
single-length quotient (QUO 
operand) to the accumulator (AL or 
AX), and returns the single-length 
remainder (the REM operand) to the 
accumulator extension (AH for 
8 -bit operation or DX for 16-bit 
operation). If the quotient is 
positive and greater than MAX or 
if the quotient is negative and 
less than O-MAX-1, (as when 
division by zero is attempted) 
then QUO and REM are undefined, 
and a type 0 interrupt is 
generated. Flags are undefined in 
any zero operation. IDIV 
truncates non-integral quotients 
and returns a remainder with the 
same sign as the numerator. 


Operands 

Bytes 

Example 


Flags 


reg8 

2 

IDIV BL 


AF=U 

PF=U 

reglS 

2 

IDIV CX 


CF=U 

SF=U 

mem8 

2-4 

IDIV DIVISOR_BYTE 

[SI] 

OF=U 

ZF=U 

meml6 

2-4 

IDIV [BX].DIVISOR 

WORD 
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IMUL IMUL source Integer Multiply 

IMUL performs a signed 
multiplication of the accumulator 
(AL or AX) and the source operand, 
returning a double-length result 
to the accumulator and its 
extension (AL and AH for 8-bit 
operation, or AX and DX for 16-bit 
operation). CF and OF are set if 
the top half of the result is not 
the sign-extension of the low half 
’ of the result. 


Operands 

Bytes 

Example 

Flags 


reg8 

2 

IMUL CL 

AF=U 

PF=U 

regl6 

2 

IMUL BX 

CF=A 

SF-U 

mem8 

2-4 

IMUL RATE BYTE 

OF=A 

ZF=U 

meml6 

2-4 

IMUL RATE_WORD[BP][DI] 



IN 

IN accumulator. 

Input Byte or Word 




source 

IN transfers a byte/word from an 
input port to the AL register (or 
AX register). The port is 
specified either with an inline 
data byte, allowing fixed access 
to ports 0 through 255, or with a 
port number in the DX register, 
allowing variable access to 64K 
input ports. 


Operands 


Bytes Example 


Flags 


accumulator, immed8 2 IN AL, OFFEAH 

accumulator, DX 1 IN AX,DX 


none 


INC 


Operands 

regl6 

reg8 

memory 


INC destination 


Increment Destination by One 


INC performs an addition of the 
operand and one, and returns the 
result to the operand. 

Bytes Example Flags 

1 INC CX AF=A SF=A 

2 INC BL OF=A ZF=A 

2-4 INC ALPHA [DI][BX] PF=A 
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INT 


INT interrupt-type Interrupt 


Operands 

inned8(type=3) 
immed8 (type^3) 


INT pushes the flag registers (as 
in PUSHF), clears the TF and IF 
flags, and transfers control with 
an indirect call through any one 
of the 256 vector elements. The 
one-byte form of this instruction 
generates a type 3 interrupt. 

Bytes Example Flags 

1 INT 3 IF-0 

2 INT 67 TF=0 


INTO 


Operands 

none 


INTO (no operands) Interrupt If Overflow 

INTO pushes the flag registers (as 
in PUSHF), clears the TF and IF 
flags, and transfers control with 
an indirect call through vector 
element 4 (location 10H) if the OF 
flag is set (trap on overflow). 

If the OF flag is clear, no 
operation takes place. 

Bytes Example Flags 

1 INTO IF=0 

TF=0 


IRET IRET (no operands) Interrupt Return 

IRET transfers control the the 
return address saved by a previous 
interrupt operation and restores 
the saved flag registers (as in 
POPF). 


Operands 

Bytes 

Example 

Flags 


none 

1 

IRET 

SF=R 

PF=R 




CF=R 

SF=R 




DF=R 

TF=R 




IF=R 

ZF=R 
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D-ll 


JA 

JNBE 


Operands 

short-label 


JA short-label Jump If Above/ 

or If Not Below or Equal 

JNBE short-label 

JA or JNBE transfers control to 
the target operand on not below or 
equal (or above). 

Bytes Example Flags 

2 JA ABOVE none 


JAE 

JAE 

short-label 

Jump If Above or Equal/ 

JNB 

or 


If Not Below 


JNB 

short-label 

JNB or JAE transfers control to 
the target operand on not below 
(or above or equal). 

Operands 


Bytes 

Example Flags 

short-label 


2 

JAE ABOVE_EQUAL none 


JB 

JNAE 

JC 


JB short-label 
or 

JNAE short-label 
or 

JC short-label 


Jump If Below/ 

If Not Above nor Equal/ 

If Carry 

JB, JNAE or JC transfers control 
to the target operand on below (or 
not above or equal). 


JB/JNAE short-label - Jump if be low/Jump if not above nor eq ua l 


Operands Bytes 

short-label 2 

JC short-label - Jump if carry 
Operands Bytes 

short-label 2 


Example Flags 

JB BELOW none 

Example Flags 

JC CARRY SET none 
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JBE JBE short-label Jump If Below or Equal/ 

^ TI Sfe siMaM ST THI ^ f ^ ^ ST 

JBE or JNA transfers control to 
the target operand on below or 
equal (or not above). 


Operands 

Bytes 

Example 

Flags 

short-label 

2 

JNA N0T_AB0VE 

none 

JCXZ 

JCXZ short-label 

Jump If CS Is Zero 




JCXZ transfers control to the 
target operand if the CX register 
is 0. 

Operands 

Bytes 

Example 

Flags 

short-label 

2 

JCXZ COUNT_DONE 

none 

JE 

JZ 

JE short-label 

or 

JZ short-label 

Jump If Equal/ 

If Zero 

JE or JZ transfers control to the 
target operand on equal (or zero). 

Operands 

Bytes 

Example 

Flags 

short-label 

2 

JZ ZERO 

none 

JG 

JNLE 

JG short-label 

or 

JNLE short-label 

Jump If Greater/ 

If Not Less nor Equal 



JG or JNLE transfers control to 
the target operand on not less or 
equal (or greater). 


Operands Bytes Example Flags 

short-label 2 JG GREATER none 
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JGE 

ONL ,.... 


JGE short-label 



Jump If Greater or Equal/ 

If Not Less - - : - 

JGE or JNL transfers control to 
the target operand on not less (or 
greater or equal). 


Operands 


Bytes Example 


Flags 


short-label 


2 JGE GREATER_EQUAL 


none 


JL 

JNGE 


Operands 

short-label 


JL short-label 
or 

JNGE 


Jump If Less/ 

If Not Greater nor Equal 

JL or JNGE transfers control to 
the target operand on less (or not 
greater or equal). 


Bytes Example 


Flags 


2 JL LESS 


none 


JLE 

JNG 


) 


Operands 


JLE short-label Jump If Less or Equal/ 

or If Not Greater 

JNG short-label 

JLE or JNG transfers control to 
the target operand on less or 
equal (or not greater). 

Bytes Example Flags 


short-label 


2 JNG NOT GREATER 


none 


JMP 

JMP target 

Jump 


- 

' 

JMP transfers control 
target operand. 

to the 

Operands 

Bytes 

Example 

Flags 

short-label 

2 

JMP SHORT 

none 

near-label 

3 

JMP WITHIN SEGMENT 

far-label 

5 

JMP FAR_LABEL 


memptrl6 

2-4 

JMP [BX].TARGET 


regptrl6 

2 

JMP CX 


memptr32 

2-4 

JMP OTHER.SEG [SI] 
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JC short-label 


Jump if No Carry 


JC t ra ns £ con^So^ t^£K¥ targe 
operand on below or equal (or not 
above). 




Operands 


Bytes 

Example 

Flags 

short-label 


2 

JNC NOT_CARRY 

none 

JNE 

JNZ 

JNE 

or 

JNZ 

short-label 

short-label 

Jump If Not Equal/ 

If Not Zero 

JNE (or JNZ) transfers control to 
the target operand on not equal 
(or not zero). 

Operands 


Bytes 

Example 

Flags 

short-label 


2 

JNE NOT_EQUAL 

none 

JNO 

JNO 

short-label 

Jump If No Overflow 




* 

JNO transfers control to the 
target operand on no overflow. 

Operands 


Bytes 

Example 

Flags 

short-label 


2 

JNO N0_0VERFL0W 

none 

JNP 

JPO 

JNP 

or 

JPO 

short-label 

short-label 

If No Parity/ 

If Parity Odd 

JNP or JPO transfers control to 
the target operand on not parity 
(or parity odd). 

Operands 


Bytes 

Example 

Flags 

short-label 


2 

JPO ODD_PARITY 

none 

JNS 

JNS 

short-label 

Jump If No Sign/ 

If Positive 





JNS transfers control 
target operand on not 

to the 
sign. 

Operands 


Bytes 

Example 

Flags 

short-label 


2 

JNS POSITIVE 

none 
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JO JO short-label Jump On Overflow 


JO transfers control to the target 
operand on overflow. 


Operands 

Bytes 

Example 

Flags 

short-label 

2 

JO SIGNED_0VRFLW 

none 

JP 

JPE 

JP short-label 
or 

JPE 

Jump ©n Parity/ 

If Parity Even 

JP or JPE transfers control to the 
target operand on parity (or 
parity even). 

Operands 

Bytes 

Example 

Flags 

short-label 

2 

JPE EVEN_PARITY 

none 

JS 

JS short-label 

Jump On Sign 




JS transfers control 
operand on sign. 

to the target 

Operands 

Bytes 

Example 

Flags 

short-label 

2 

JS NEGATIVE 

none 

LAHF 

LAHF (no operands) Load AH from Flags 


i 


LAHF transfers the flag registers 

SF, ZF, AF, PF, and OF into 
specific bits of the AH register. 

Operands 

Bytes 

Example 

Flags 

none 

1 

LAHF 

none 


'<■; 


The 8036 Instruction Set 




D-16 


LDS destination. 


Load Data Segment Register 

LDS transfers a "pointer-object" 

(a 32-bit object containing an 
offset address and a segment 
address) from the source operand 
(which must be a doubleword memory 
operand) to a pair of destination 
registers. The segment address is 
transferred to the DS segment 
register. The offset address may 
be transferred to any 16-bit 
general, pointer, or index 
register you specify (not a 
segment register). 


Operands 


Bytes Example 


Flags 


reg!6, mem32 


2-4 LDS SI, DATA.SEG[DI] 


LEA destination. 


Load Effective Address 


LEA transfers the offset address 
of the source operand to the 
destination operand. The source 
operand must be a memory operand 
and the destination operand can be 
any 16-bit general, pointer, or 
index register. LEA allows the 
source to be subscripted. This is 
not allowed using the MOV 
instruction with the OFFSET 
operator. Also, the later 
operation invariably uses the 
offset of the variable in the 
segment where it was defined. 

LEA, however, will take into 
account a group offset if the 
group is the only possible access 
route via the latest ASSUME 
directive. 


Operands 


Bytes Example 


Flags 


regl6, mem!6 


2-4 LEA BX,[BP][DI] 
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LES 


Operands 
regl6, mem32 

LOCK 


Operands 

none 


LES destination , Load Extra Segment Register 

source 

LES transfers a "pointer object" 

(a 32-bit object containing an 
offset address and a segment 
address) from the source operand 
(which must be a doubleword memory 
operand) to a pair of destination 
registers. The segment address is 
transferred to the ES segment 
register. The offset address may 
be transferred to a 16-bit 
general, pointer, or index 
register (not a segment register). 

Bytes Example Flags 

2-4 LES DI,[BX] .TEXT BUFF none 


LOCK (no operands) Lock Bus 

A special one-byte lock prefix nay 
precede any instruction. It 
causes the processor to assert its 
bus-lock signal for the duration 
of the operation caused by the 
instruction. In multiple 
processor systems with shared 
resources it is necessary to 
provide mechanisms to enforce 
controlled access to those 
resources. Such mechanisms, while 
generally provided through 
software operating systems, 
require hardware assistance. A 
sufficient mechanism for 
accomplishing this is a locked 
exchange (also referred to as 
test-and-set-lock). 

Bytes Example Flags 

1 LOCK XCHG FLAG,AL none 
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LODS 

LODSB 

LODSW 


Operands 


LODS source-string 
or 

LODSB (no operands) 
or 

LODSW (no operands) 


Load Byte or Word String 

LODS transfers a byte (or word) 
operand from the source operand 
addressed by SI to accumulator AL 
(or AX) and adjusts the SI 
register by DELTA. This operation 
ordinarily would not be repeated. 


Bytes Example 


Flags 


source—string 1 LODS CUSTOMER^NAME none 

(repeat) source-string 1 REP LODS NAME 


LOOP LOOP short-label Loop until Count Complete 

LOOP decrements the CX (count) 
register by 1 and transfers 
control to the target operand 
(short label) if CX is not zero. 

Operands Bytes Example Flags 

short-label 2 LOOP AGAIN none 


LOOPS 

LOOPZ 


LOOPE short-label 
or 

LOOPZ short-label 



Loop If Equal/ 
If Zero 


LOOPE or LOOPZ decrements the CX 
register by one and transfers if 
CX is not zero and if the ZF flag 
is set to 1. 


Operands Bytes Example Flags 

short-label 2 LOOPE AGAIN none 


LOOPNE 

LOOPNZ 


LOOPNZ short-label Loop If Not Equal/ 

or If Not Zero 

LOOPNE short-label 

LOOPNZ or LOOPNE decrements the CX 
register by one and transfers if 
CX is not zero and the ZF flag is 
cleared. 


Operands 


Bytes Example 


Flags 


short-label 


2 LOOPNE AGAIN 


none 
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MOV destination, 


Operands 

memory, accumulator 
accumulator, memory 
register, register 
register, memory 
memory, register 
register, immediate 
memory, immediate 
seg-reg, regl6 
seg-reg, meml6 
regl6, seg-reg 
memory, seg-reg 


The seven separate types of move 
instructions are described below. 

Each type has multiple uses and 
encodings depending on the type of 
data being moved and the location 
of that data. The assembler 
generates the correct encoding 
based on these two factors. 


Bytes Example 


Flags 


MOV ARRAY [SI], AL 
MOV AX, TEMP_RESULT 
MOV AX, CX 
MOV BP, STACKTOP 
MOV COUNT [DI], CX 
MOV CL, 2 

MOV MASK [BX][SI], 2CH 
MOV ES, CX 
MOV DS, SEGMENT_BASE 
MOV BP,SS 

MOV [BX].SEG_SAVE, CS 
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MOVS MOVS dest-string , 

MOVSB source-string 

MOVSW or 

MOVSB (no operands) 
or 

MOVSW (no operands) 


Move Byte or Word String 

MOVS transfers a byte (or word) 
operand from the source operand 
addressed by SI to the destination 
operand addressed by DI, and 
adjusts the SI and DI registers by 
DELTA (number of bytes specified 
by the operand TYPE). As a 
repeated operation this provides 
for moving a string from one 
location in memory to another. 


MOVS dest-string, source-string - MOVE string 


Operands 

Bytes 

Example 

Flags 

dest-string, 

source-string 

1 

MOVS LINE EDITJDATA 

none 

(repeat) dest-string, 
source-string 

1 

REP MOVS SCREEN, BUFFER 


MOVSB/MOVSW no operands 

- Move string (byte/word) 


Operands 

Bytes 

Example 

Flags 

none 

1 

MOVSB 

none 

(repeat) none 

1 

REP MOVSW 



MUL MUL source Multiply, Unsigned 

MUL performs an unsigned 
multiplication of the accumulator 
(AL or AX) and the source operand, 
returning a double-length result 
to the accumulator and its 
extension (AL and AH for 8-bit 
operation, or AX and DX for 16-bit 
operation). CF and OF are set if 
the top half of the result is 
non-zero. 


Operands 

Bytes 

Example 

Flags 


reg8 

2 

MUL BL 

AF=U 

PF=U 

regl6 

2 

MUL CX 

CF=A 

SF=U 

mem8 

2-4 

MUL MONTH [SI] 

OF=A 

ZF=U 

meml6 

2-4 

MUL BAUD RATE 
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NEG NBG destination Negate/ 

Form 2's Complement 

NEG performs a subtraction of the 
operand from zero, adds 1, and 
returns the result to the 
operand. This forms the 2's 
complement of the specified 
operand. 


Operands 

Bytes 

Example 

Flags 

register 

2 

NEC AL 

AF=A PF=A 

memory 

2-4 

NEG MULTIPLIER 

CF=1* SF=A 
OF=A ZF=A 

*0 if destination = 0 




NOP NOP <no operands) 

1 No Operation 




NOP causes no operation. 

Operands 

Bytes 

Example 

Flags 

none 

1 

NOP 

none 

NOT NOT destination 

NOT forms the ones complement of 



the operand and returns 

the result 



to the operand. Flags 
affected. 

are not 

Operands 

Bytes 

Example 

Flags 

register 

2 

NOT AX 

none 

memory 

2-4 

NOT CHARACTER 


OR OR destination. 

Logical Inclusive OR 


source 






OR performs the bit logical 
inclusive disjunction of the two 
operands and returns the result to 



one of the operands. 


Operands 

Bytes 

Example 

Flags 

register, register 

2 

OR AL, BL 

AF=U PF=A 

register, memory 

2-4 

OR DX, PORT ID [DI] 

CF=0 SF=A 

memory, register 

2-4 

OR FLAG BYTE, CL 

OF=0 ZF=A 

accumulator, immediate 

2-3 

OR CS, 01FH 


register, immediate 

3-4 

OR CX, 01FH 


memory, immediate 

3-6 

OR[BS] SMD WORD,OCFH 
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OUT OUT port / Output Byte or Word 

accumulator 

OUT transfers a byte (or word) 
from the AL register (or AX 
register) to an output port . The 
port is specified either with an 
inline data byte, allowing fixed 
access to ports 0 through 255, or 
with a port number in the DX 
register, allowing variable access 
to 64K output ports. 


Operands 

Bytes 

Example 


Flags 

imned8, accumulator 

2 

OUT 44, 

AX 

none 

DX, accumulator 

1 

OUT DX, 

AL 



POP 


POP destination 


POP Word Off Stack to Destination 


Operands 

register 

seg-reg (CS illegal) 
memory 


POP transfers a word operand from 
the stack element addressed by the 
SP register to the destination 
operand and then increments SP by 
2. There are three separate types 
of POP instructions, for different^ 
destinations. m 


Bytes Example Flags 

1 POP DX none 

1 POP DS 

2-4 POP PARAMETER 


POPF POPF (no operands) POPF transfers specific bits of 

the stack element addressed by the 
SP register to the flag registers 
and then increments SP by 2. 


Operands 

Bytes 

Example 

Flags 


none 

1 

POPF 

AF=R 

PF=R 




CF=R 

SF=R 




DF-R 

TF=R 




IF-R 

ZF-R 
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PUSH PUSH source 


Push Word onto Stack 


Operands 

register 

seg-reg (CS legal) 
memory 


PUSH decrements the stack pointer 
SP by 2 and then transfers a word 
from the service operand to the 
stack element currently addressed 
by SP. There are three separate 
types of PUSH instructions 
depending on the kind of operand 
supplied. 

Bytes Example Flags 

1 PUSH SI none 

1 PUSH ES 

2-4 PUSH RETURN_CODE [SI] 


PUSHF (no operands) PUSHF decrements the SP register 

by 2 and transfers all of the flag 
registers into specific bits of 
the word operand (stack element) 
addressed by SP. 


^ Operands 

none 

Bytes 

1 

Example 

PUSHF 

Flags 

none 

RCL 

RCL destination. 

Rotate Left 

through Carry 


source 





RCL rotates 

the operand left 



through the CF flag register by 



COUNT bits. 


Operands 

Bytes 

Example 

Flags 

register, 1 

2 

RCL CX, 1 

CF=A 

register, CL 

2 

RCL AL, CL 

OF=A 

memory, 1 

2-4 

RCL ALPHA, 1 


memory, CL 

2-4 

RCL [BPJ.PARM, CL 
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RCR RCR destination , Rotate Right through Carry 
count 

RCR rotates in EA operand right 
through the CF flag register by 
count bits. 


Operands Bytes 

register, 1 2 

register, CL 2 

memory, 1 2-4 

memory, CL 2-4 


Example Flags 

RCR BX, 1 CF=A 

RCR BL, CL OF=A 

RCR [BX]. STATUS, 1 
RCR ARRAY [DI], CL 


REP 

REPZ 

REPE 

REPNE 

REPNZ 


REP (no operands) 
or 

REPZ (no operands) 
or 

REPE (no operands) 
or 

REPNE (no operands) 
or 

REPNZ (no operands) 


Repeat String Operation 

REP causes the primitive string 
operation that follows to be 
performed repeatedly while (CX) 
is not zero. In the case of CMPS 
and SCAS, if after any repetition 
of the primitive operation the ZF 
flag differs from the "z" bit of 
the repeat prefix, the repetition 
is terminated. This prefix may be 
combined with the segment override 
and/or LOCK prefixes, although l 
with multiple prefixes, interrupts" 
must be disabled, because the 
return from an interrupt returns 
control to the interrupted 
instruction or to at most one 
prefix byte before that 
instruction. 


REP (no operands) - Repeat string operation 

Operands Bytes Example Flags 

none 1 REP MOVS DEST,SRCE none 

REPE/REPZ (no operands) -Repeat string operation while equal/while zero 

Operands Bytes Example Flags 

none 1 REPE CMPS DATA,KEY none 

REPNE/REPNZ (no operands) - Repeat string operation while not equal/not 
zero 

Operands Bytes Example Flags 

none 1 REPNE SCAS INPUT LINE none 
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RET RET [ pop-value ] Return from Procedure 

RET transfers control to the 
return address pushed by a 
previous CALL operation and 
optionally adds an immediate 
constant, pop-value , to the SP 
register to discard stack 
parameters. If this is an 
inter-segment RET, it was 
assembled under a procedure 
labeled FAR, it will replace the 
IP and the CS using the two words 
at the top of the stack. 

Otherwise, only the IP is 
replaced, using only one word froa 
the top of the stack. 

When using indirect CALLs, you 
must carefully ensure that the 
type of CALL matches the type of 
return in the procedure. 

CALL WORD PTR [BX] 

must not invoke a FAR procedure. 
And, 

CALL DWORD PTR [BX] 

must not invoke a NEAR procedure. 


Operands 

Bytes 

Example 

Flags 

(intra-segment, no pop) 

1 

RET 

none 

(intra-segment, pop) 

3 

RET 4 


(inter-segment, no pop) 

1 

RET 


(inter-segment, pop) 

3 

RET 2 



ROL 

ROL destination, 
count 

Rotate Left 




ROL rotates the operand 
count bits. 

left by 

Operands 

Bytes 

Example 

Flags 

register, 1 

2 

ROL BX, 1 

CF=A 

register, CL 

2 

ROL DI, CL 

OF=A 

memory, 1 

2-4 

ROL FLAG BYTE [ DI ], 1 


memory, CL 

2-4 

ROL ALPHA, CL 
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ROR 


ROR destination. 

Rotate Right 

* 




count 

ROR rotates the operand 
count bits. 

right by^J 

Operands 



Bytes 

Example 

Flags 

register. 

1 


2 

ROR AL, 1 

CF=A 

register. 

CL 


2 

ROR BX, CL 

0F=A 

memory, 1 



2-4 

ROR PORT STATUS, 1 


memory, CL 


2-4 

ROR CMD WORD, CL 


SAHF 


SAHF (no operands) SAHF transfers specific 

bits of 





the AH register to the flag 
registers SF, ZF, AF, PF, and CF. 
The bits of AH indicated by M X" in 
the operation are ignored. 

Operands 



Bytes 

Example 

Flags 

none 



1 

SAHF 

AF=R SF=R 
CF=R ZF=R 
PF=R 

SAL 


SAL 

destination. 

Shift Arithmetic Left/ 

| 

SHL 


or 

count 

Shift Logical Left 




SHL 

destination. 

SAL and SHL shift the operand left 




count 

by count bits, shifting 
order zero bits. 

in low- 

Operands 



Bytes 

Example 

Flags 

register. 

1 


2 

SAL AL, 1 

CF=A 

register. 

CL 


2 

SHL DI, CL 

0F=A 

memory, 1 



2-4 

SHL [BX]. OVERDRAW, 1 


memory,CL 



2-4 

SAL STORE COUNT, CL 
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SAR 


Operands 

register, X 
register, CL 
memory, 1 
memory, CL 


SAR destination , 
count 


SAR (shift arithmetic right) 
shifts the destination operand 
right by count bits, shifting in 
high-order bits equal to the 
original high-order bit of the 
operand (sign extension). 


Bytes 

Example 

Flags 


2 

SAR DX, 1 

AF=U 

PF=A 

2 

SAR DI, CL 

CF=A 

SF-A 

2-4 

SAR N_BLOCKS, 1 

OF=A 

ZF-A 

2-4 

SAR NBLOCKS, CL 





SBB destination , 
source 


Subtract with Borrow 

SBB performs a subtraction of the 
two operands, subtracts one if the 
CG flag is set, and returns the 
result to one of the operands. 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

SBB BX, CX 

AF=A 

PF=A 

register, memory 

2-4 

SBB DI, [BX],PAYMENT 

CF=A 

SF=A 

memory, register 

2-4 

SBB BALANCE, AX 

OF=A 

ZF=A 

accumulator, immediate 

2-3 

SBB AX, 2 

register, immediate 

3-4 

SBB CL, 1 



memory, immediate 

3-6 

SBB CO(JNT[SI], 10 




SCAS SCAS dest-strinq 

SCASB pr 

SCASW SCASB (no operands) 

or 

SCASW (no operands) 


Scan Byte or Word String 

SCAS subtracts the destination 
byte (or word) operand addressed 
by DI from AL (or AX) and affects 
the flags but does not return the 
result. As a repeated operation 
this provides for scanning for t***» 
occurrence or, or departure from, 
a given value in a string. See 
REP instruction in this chapter. 


Operands 

Bytes 

Example 

Flags 

dest-string 

1 

SCAS INPUT_LINE 

AF=A PF=A 

(repeat) dest-string 

1 

REPNE SCAS BUFFER 

CF=A SF=A 
0F=A ZF=A 
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SHR 

SHR destination. 

Shift Logical Right 




count 

SHR shifts the operand 

right 




shifting in high-order 

zero bits. 

Operands 


Bytes 

Example 

Flags 

register, 1 


2 

SHR SI, 1 

CF=A 

register, CL 


2 

SHR SI, CL 

OF=A 

memory,1 


2-4 

SHR ID_BYTE [SI][BX], 1 


memory, CL 


2-4 

SHR INPUT_WORD, CL 


STC 

STC 

(no operands) 

Set Carry Flag 





STC sets the CG flag. 


Operands 


Bytes 

Example 

Flags 

none 


1 

STC 

CF=1 

STD 

STD 

(no operands) 

Set Direction Flag 





STD sets the DF flag causing the 
string operations to auto¬ 
decrement the operand index(es). 

Operands 


Bytes 

Example 

Flags 

none 


1 

STD 

DF=1 

STI 

STI 

(no operands) 

Set Interrupt Flag (Enable) 




STI sets the IF flag. 

enabling 




maskable external interrupts after 
the execution of the next 




instruction. 


Operands 


Bytes 

Example 

Flags 

none 


1 - 

STI 

IF=1 
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STOS STOS destination- 

string 
or 

STOSB (no operands) 
or 

STOSW (no operands) 


Store Byte or Word String 

STOS transfers a byte (or word) 
operand from AL (or AX) to the 
destination operand addressed by 
DI and adjusts the DI register by 
DELTA. As a repeated operation 
(see REP) this provides for 
filling a string with a given 
value. The operand named in the 
STOS instruction is used only by 
the assembler to verify type and 
accessibility using current 
segment register contents. The 
actual operation of the 
instruction uses only DI to point 
to the location being stored into. 


Operands Bytes Example Flags 

dest-string 1 STOS PRINTLINE none 

(repeat) dest-string 1 REP STOS DISPLAY 


SUB SUB destination . Subtract 

source 

SUB performs a subtraction of the 
source from the destination . The 
result goes to the destination 
operand. 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

SUB CX, BX 

AF=A 

PF=A 

register, memory 

2-4 

SUB DX, MATH TOTAL[SI] 

CF=A 

SF=A 

memory, register 

2-4 

SUB [BP+2], CL 

OF=A 

ZF=A 

accumulator, immediate 

2-3 

SUB AL. 10 



register, immediate 

3-4 

SUB SI. 5280 



memory, immediate 

3-6 

SUB [BP].BALANCE, 1000 




The 8086 Instruction Set 


D-30 


TEST TEST destination . Test (logical Compare) 

source 

TESt performs the bit-to-bit 
logical conjunction of the two 
operands, causing the flags to be 
affected, but does not return the 
result. 

The source (right-most) operand 
must be of the same type (byte or 
word) as the destination operand. 
The only exception for TEST is 
testing an immediate-data byte 
with a memory word. 


Operands 

Bytes 

Example 

Flags 


register, register 

2 

TEST SI, DI 

AF=U 

PF=A 

register, memory 

2-4 

TEST SI, END_C0UNT 

CF=0 

SF=A 

accumulator, immediate 

2-3 

TEST AL, 00100000B 

OF=0 

ZF=A 

register, immediate 

3-4 

TEST BX, 0CC4H 



memory, immediate 

3-6 

TEST RETURN CODE, 01H 




WAIT 


Operands 

none 


WAIT (no operands) Wait 

This instruction allows the 
processor to synchronize itself 
with external hardware by placing 
the processor in a wait state 
until an external interrupt occurs. 

Bytes Example Flags 

1 WAIT, none 


XCHG XCHG destination . Exchange 

source 

XCHG exchanges the byte or word 
source operand with the 
destination operand. 

Operands Bytes Example Flags 


accumulator, regl6 
memory, register 
register, register 


1 XCHG AX, BX 

2-4 XCHG SEMAPHORE, AX 

2 XCHG AL, BL 


none 
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XLAT 


XLAT source-table Translate 


} 


Operands 


XLAT performs a table lookup byte 
translation. The AL register is 
used as an index into a table 
(256-bytes at most) addressed by 
the BX register. The byte operand 
so addressed is transferred to AL. 

Bytes Example Flags 



Operands 

Bytes 

Example 

Flags 


register,- register 

2 

XOR CX, BX 

AF=U 

PF=A 

register, memory 

2-4 

XOR CL, MASK BYTE 

CF=0 

SF=A 

memory, register 

2-4 

XOR ALPHA [SI], DX 

OF=0 

ZF=A 

accumulator, immediate 
register, immediate 
memory, immediate 

2- 3 

3- 4 

3-6 

XOR AL, 010000010B 

XOR SI, 00C2H 

XOR RETURN CODE 0D2H 
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h- ---- 

A - i h - * • 

Address, 1—2, 2—1, 2—3, 2—4, 3—1, 

3- 2, 3-4, 3-6, 3-10, 3-11, 

4- 1, 4-4, 4-5, 4-8 to 4-11, 

5- 2, 5-3, 5-5, 5-6, 5-8, 

6- 1, 6-3 to 6-7, 7-3, 10-3, 

10- 9 to 10-11, 11-2, 11-3, 
B-3, D-3, D-10, D-16, D-17, 
D-25 

Addressing inodes, 2-3, 2-5, D-7 
Addressing through Base and 

Index Registers Plus an 
Offset, 2-4 

Align-type of segments, 6-4, 
10 - 10 ' 

Ampersand, 7-7, B-2 
AND, 4-3, 4-4 

Angle Brackets, 4-14, 5-11, 7-2, 

7- 6 to 7-8, 8-3, 8-4, B-2, 
B-4 

thmetic operators, 4-1 
II Character Codes, A-l 
Assembler 

errors, 1-1, 1-2, 1-10, 2-5, 
6-4, 7-8, 8-1, 10-1, 10-2, 
10 - 6 , 11 - 1 , 11 - 2 , 

11- 7 to 11-9, 12-5 
loading, 1-3 to 1-9 
starting, 1-3 to 1-9 

Assembler, invoking of, 1-3 to 
1-5 

Assembler, operation of, 1-3 
ASSUME, 3-4, 3-6, 4-5, 4-9, 

4-10, 5-1, 5-2, 5-8, 6-3, 
6-6, 6-7, 7-4, 10-2, 10-4, 
10-5, 11-1, 11-3, 11-5, 

B—1, D-16 

ASSUME NOTHING, 5-2, B-l 
At Combine Type, 6-4, 10-2, 10-3, 
10-13 

Attribute, 10-12 
Attributal operators, 4-4 
Auxiliary carry flag, 2-5 

/■ t !" h :; -1 


Base addresses, 2-1, 6-4, 10-9 
Base registers, 2-4 
Block nesting error, 11-3, C-l 
Byte Align Type, 6-4, 10-10 / 

c h ’ - ' . ; " • 

Carry flag, 2-5 
Character string, 3-8 
Class Name, 6-6 

Clear direction flag, 2-5, 2-6 
Colon - segment override 

operator, 4-9 to 4-14 
Combine type, 3-3, 6-3 to 6-5, 
10-1, C-l 

Command characters, 12-3, 1-9 
Command statement, the elements 
of, 3-6 to 3-9 

Comments, 3-6, 3-8, 7-8, 9-6, 
U-3 

COMMENT directive, 3-8 t 9-6 / 

COMMON combine type, 6-4, 10-11 
Conditional directives, 1-1, 

4- 2, 8-1 to 8-3, B-3 
Constants, 2—2, 3—2, 3—6, 

3-8 to 3-10, 4-1, 5-1, 

5- 3, 5-4, 5-9, 7-6 
Control Characters 

carriage return, 1-9 
comma, 1-9 

CONTROL-C, 12-3, 12-4 
2ND-C0MMAND-CANCEL, 12-3 
semicolon, 1-8, 1-9, 3-2, 3-8, 
7-7, 7-8, 11-3, 12-2, 12-3 
SHIFT-CANCEL, 1-9 
Control characters for assembly, 
1-8 

Count, shift, 4-11, 4-12, 5-9, 

10-8, 10-9, 11-7, B-4, C-l 
B-3 

CREF, 9-6, 10-1, 12-1 to 12-6, 

12-8, B-3 

.CREF, 9-6, 12-1 to 12-5, 12-8, 
B-3 
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Cross-reference file, 1-2, 1-4, 

I- 6, 1-9, 9-4, 9-6, 9-7, 

10-1, 12-1 to 12-8 

command characters, 12-3 
error messages, 1-10, 11-1, 

II- 8. 11-9, 12-5, C-l 
format, 12-6 

invoking, 12-2 


Data allocation statement, 5-1, 

5-2, 5-10, 5-11, 5-13 
Data items, 3-9 

constants, 2—2, 3-2, 3-6, 

3-8 to 3-10, 4-1, 5-1, 5-3, 
5-4, 5-9, 7-6 

labels, 1-2, 3-6, 3-7, 3-9, 

3-10, 4-8 to 4-10, 5-1, 

5- 8, 6-2, 6-4, 7-3, 11-9 
variables, 1-2, 2-2, 3-4, 

3- 6 to 3-10, 4-1, 4-2, 4-5, 

4- 8, 4-9, 5-9, 5-12, 6-4, 

6- 5, 7-3, 9-7, 10-4 
Default extension names, 1-4 
DB, 3-5 to 3-7, 5-1 to 5-3, 5-9, 

5- 12, 5-13, 6-5, 

7- 4 to 7-7, 7-9, 10-4, 

11-1, B-l 

DD, 3-6, 4-5, 4-5, 5-1 to 5-3, 

5-9, 5-12, 5-1 to 5-3, 5-9, 
5-12, B-l, B-l 

DQ, 3-6, 5-1 to 5-3, 5-9, 5-12, 
B-l 

DT, 3-6, 5-1 to 5-3, 5-9, 5-12, 
B-l 

DM, 3-4 to 3-7, 4-5 to 4-7, 4-9, 

5- 1 to 5-3, 5-9, 5-12, 6-2, 

6- 6, 7-4, 10-2, 11-2, 11-5, 
11-6, B-l 

Direction flag, 2-6 

Direct offset addressing, 2-3 

Directives, 1-1, 1-5, 3-1, 3-5, 

3- 9, 4-2, 4-11, 5-1, 5-7, 

5- 12, 6-1, 6-3, 8-1 to 8-3, 

9- 1. 9-3 to 9-6, 10-11, 

10- 12, 11-3, B-l to B-3 
ASSUME, 3-4, 3-6, 4-5, 4-9, 

4- 10, 5-1, 5-2, 5-8, 6-3, 

6- 6, 6-7, 7-4, 10-2, 10-4, 
10-5, 11-1, 11-3, 11-5, B-l 


ASSUME NOTHING, 5-2, B-l 
COMMENT, 3-5, 3-6, 3-8, 7-8, 

9- 6, B-2 

.CREF, 9-6, 12-1 to 12-5, 

12-8, B-3 

DB, 3-5 to 3-7, 5-1 to 5-3, 

5-9, 5-12, 5-13, 6-5, 

7-4 to 7-7, 7-9, 10-4, 

11-1, B-l 

DD, 3-6, 4-5, 4-5, 5-1 to 5-3, 
5-9, 5-12, 5-1 to 5-3, 5-9, 
5-12, B-l, B-l 
DQ, 3-6, 5-1 to 5-3, 5-9, 

5-12, B-l 

DT, 3-6, 5-1 to 5-3, 5-9, 

5-12, B-l 

DW, 3-4 to 3-7, 4-5 to 4-7, 

4- 9, 5-1 to 5-3, 5-9, 

5- 12, 6-2, 6-6, 7-4, 10-2, 
11-2, 11-5, 11-6, B-l 

ELSE, 8-1, 11-2, 11-3, 11-6, 

B-3 

END, 3-2, 3-3, B-2 
ENDS, 3-2, 3-3, B-2 
ENDC, 8-1 to 8-4 
ENDIF, 8-1, 9-4, 11-6, B-3 
ENDM, 7-1, 7-4 to 7-7, 7-9, 

10- 4, B-2 

ENDP, 5-1, 5-7, 5-8, 7-4, 10-5 
EQU, 3-5, 3-9, 3-10, 4-9, 5-1, 
5-4, 5-7, 6-2, 7-9, 10-4, 
10-5, 10-11, 10-12, 11-3, 
B-l 

Equal sign, 5-4 
EVEN, 5-5, B-l 
EXITM, B-2, 6-2, 6-3 
EXTRN, 5-6, 6-1 to 6-3, B-l 
GROUP, 6-6, 6-7, 10-3, 10-4, 
10-8 to 10-10, 11-5, 11-7, 
B-3 

IF, 1-1, 1-3 to 1-5, 8-1 to 8-4 

IF1, 8-1, 8-2, 9-3, 9-4, B-3 

IF2, 8-1, 8-3, 9-3, 9-4, B-3 

IFB, 8-1, 8-3, B-3 

IFDEF, 8-1 to 8-3, B-3 

IFDIF, 8-1, 8-3, B-3 

IFE, 8-1, 8-2, B-3 

IFIDN, 8-1, 8-3, B-3 

IFNB, 8-1, 8-4, B-3 

IFNDEF, 8-1 to 8-3, B-3 
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INCLUDE, 5-1, 5-3, 5-5, 5-12, 
7-3, 9-2, 10-1, 10-6, 10-9 
IRP, 3-1, 7-5 to 7-7, 11-3, B-2 
IRPC, 7-6, B-2 
LABEL, 5-6 

.LALL, 7-8, 9-6, B-3 
.LPCOND, 1-5, 9-5, B-3 
.LIST, 1-4, 1-10, 9-4, 9-5, 

B-3 

LOCAL, 4-8, 6-1, 7-3, 7-4, 

11-2, 11-7, B-2 

MACRO, 1-1, 1-2, 3-1, 4-8, 7-1 
to 7-9, 8-2 to 8-4, 9-3, 

9- 4, 9-6, 10-1, 10-5, 

10- 7, B-2 
NAME, 5-6 

ORG, 5-1, 5-7, B-l 
%OUT, 9-3, 9-4, 11-1, B-3, D-22 
PAGE, 9-1 to 9-3 
PROC, 5-1, 5-7, 5-8, 6-2, 7-4, 
10-4, 10-5, 10-12, 10-13, 
B-l, D-3 

PUBLIC, 3-3, 5-8, 6-1, 6-2, 

6-4 to 6-6, 10-4, 10-5, 

10- 10, 10-11, 11-8, B-l 
PURGE, 7-3, B-2 
.RADIX, 5-1, 5-9, B-l 
RECORD, 5-9, B-4, C-l 
REPT, 7-5, 10-4, 11-3, B-2 
.SALL, 9-6, B-3 
SEGMENT, 3-2 to 3-7 
.SFCOND, 1-5, 9-5, B-3 
STRUC, 4-6, 5-1, 5-11 to 5-13, 

11- 3, 11-4, 11-6, 11-7, C-2 
SUBTTL, 9-1 to 9-3, B-3 
.TFCOND, 1-5, 9-5, 9-6, B-3 
TITLE, 5-6, 9-1 to 9-3, 12-6, 

12- 7, B-3 

.XALL, 7-8, 9-6, B-3 
.XCREF, 9-6, 9-7, B-3 

.XLIST, 9-4, 9-5, B-3 

DUP, 3-1, 4-4, 4-6, 4-7, 5-3, 

5-10 to 5-13, 6-5, 10-4, 

10-5, 11-3, 11-4, 11-7, C-2 



E__ - 

Editor, 1-3, 1-10 

, 8 - 1 , 11 - 2 , 11 - 3 , 11 - 6 , 

B-3, 

1-5, 3-2, 3-3, B-2, D-30 



ENDIF, 8-1, 9-4, 11-6, B-3 
ENDM, 7-1, 7-4 to 7-7, 7-9, 

10- 4, B-2 

ENDP, 5-U 5-7i 5-8, 7-4, 10-5 
ENDS, 2-1, 3-2, 3-3, B-2 
EQU directive, 10-5, 10-12, 5-1, 
5-4 1 

Equal sign, 5-4' 

Error messages, 1-10, 

11- 1 to 11-9, C-l 
Error messages of CREF, 12-5 
exclamation mark, 7-7, 7-8 
Executable, creating a file, 1-10 
EVEN directive, 5-5/ 11-3 
EXITM, B-2 

expressions, 3-9 
extensions 

default, 1-2, 1-4 to 1-6, 1-8, 
1-9, 2-4, 3-2, 4-9, 5-1, 
5-2, 5-8, 5-9, 6-4, 7-8, 
9-2, 9-4, 9-6, 10-1, 

12- 1 to 12-3, 12-7, D-5 
EXTRN directive, 6-2, 6-3, 10-9 

to 10-12 


FAR, 3-7, 4-6, 4-8, 4-10, 5-6, 

5-8, 5-9, 6-2, 10-4, 10-5, 
10-12, 10-13, B-l, D-3, 
D-13, D-25 

Flags, 2-5, 2-6, D-l to D-31 
Fields of records, 4-1 
Format directives, 9-1 
PAGE, 9-1 to 9-3, B-3 
TITLE, 9-1 to 9-3, B-3 
SUBTTL, 9-1 to 9-3, B-3 
Formats of listing and symbol 
tables, 10-1 
Formatting, 12-6 


General purpose registers, 2-2, 
2-3 

GROUP directive, 4-5, 4-10, 5-2, 
6-6 


HIGH, 4-11, B-4 
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Identifiers, 3-6 

IF, 1-1, 1-3 to 1-5, 8-1 to 8-4, 
B—3 

IF1, 8-1, 8-2, 9-3, 9-4, B-3 

IF2, 8-1, 8-3, 9-3, 9-4, B-3 

IFB, 8-1, 8-3, B-3 

IFDEF, 8-1 to 8-3, B-3 
IFDIF, 8-1, 8-3, B-3 
IFE, 8-1, 8-2, B-3 
IFIDN, 8-1, 8-3, B-3 
IFNB, 8-1, 8-4, B-3 
IFNDEF, 8-1 to 8-3, B-3 
Immediate operands, 3-10 
INCLUDE, 5-1, 5-3, 5-5", 5-12, 

7-3, 9-2, 10-1, 10-6, 10-9 
Indexed memory operands, 3-10, 

3-U 

Indirect addressing, 2-3, 2-4 
Index registers, 2-2 to 2-4, 

3-9, 3-10 

Instruction set, D-l 
Interrupt flag, D-4, D-28 
I/O handler errors, 11-1, 11-8 
Invoking a macro, 7-2 
Invoking the assembler, 1-5, 3-2 
method one, 1-4, 1-8, 1-9, 

3-2 

method two, 1-4, 1-5, 1-7, 

1-8 

the "Other" option, 1-6 
IRP, 3-1, 7-5 to 7-7, 11-3, B-2 
IRPC, 7-6, B-2 

LABEL, 5-6, B-l 
Labels, 1-2, 3-4'to 3-7, 3-9, 
3-10, 4-8 to 4-10, 5-1, 
5-8, 6-2, 6-4, 7-3, 11-9 
.LALL, 7-8, 9-6, B-3 
Legal characters, 3-1 
LENGTH, 4-6, B-4, 

.LFCOND, 1-5, 9-5, B-3 

.LIST, 1-4, 1-10, 9-4, 9-5, B-3 

Listing File, 1-2, 1-4 to 1-6, 

7-3, 7-4, 9-1, 9-3 to 9-5, 

10- 1, 10-2, 10-4, 11-1, 

11 - 8 


Listing file of CREF, 

12-5 to 12-7 

LOCAL, 4-8, 6-1, 7-3, 7-4, 

11-2, 11-7, B-2 

Logical operators, 4-1, 4-3, 4-4 
LOW, 4-11', B-4 

Macro, 1-1, 1-2, 3-1, 4-8, 

7-1 to 7-9, 8-2 to 8-4, 

9- 3, 9-4, 9-6, 10-1, 10-5, 

10- 7, B-2 

creating a macro, 7-1 
deleting a macro, 7-3 
invoking a macro, 7-2, 7—2 
operators, 7-7 to 7-9, B-2 
MASK, 3-9, 4-11, 4-13; 4-14, 

5- 9, 5-11, 10-6 to 10-9, 
B-4, D-19, D-31 

Memory combine type, 6-4, 6-10, 

6 - 11 , 

Memory operands, 3-10, 3-11 
Memory organization, 3-5, 3-9 
Menu, creating an assembly 

language selection, 1-7 
Messages, 1-10, 11-1, 11-8, 11-9, 

12-5, C-l 

assembler, 12-1 to 12-8, B-l, 
I/O handler, 11-1, 11-8 
runtime, 3-3, 11-1, 11-9 
Method one for invoking the 
assembly, 1-4 

Method two for invoking the 
assembly, 1-5 

Module, 1-8, 3—2, 3—4, 4-2, 5-6, 
6—1 to 6—3, 6—5, 7—1, 9—2, 
B-2 

NAME, 5-8, B-l to B-3 

NONE combine type, 6-4, 10-10 

Numeric notation, 3-7 

Object module, 1-4 
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1-2, 2-1 to 2-4, 3-2, 

£_ 

3- 6, 3-7, 3-10, 4-4, 4-5, 

4- 8, 4-9, 4-15, 5-6 to 5-8, 

Page, 3-3, 6-4 

5-13, 6-1, 6-3, 6-6, 6-7, 

12-6 to 

7-3, 10-1 to 10-3, 10-6, 

PAGE directive 

10-8, 10-11, 10-13, B-4, 

PARA, 10-6, 10 

D-3, D-16, D-17 

Parameters, 3- 


OFFSET, 4-5 
Offset attribute, 3-7 
Operands, 3-1, 3-6, 3-9 to 3-11, 

4- 1 to 4-4, 4-8, 5-4* 

5- 11, 5-13, 11-2, 11-6, 

C-2, D-l to D-31 

Operators, / 

arithmetic, 2-3, 4-1, 11-9, 
D-26, D-27 

attributal, 4-1, 4-4' 

HIGH, 4-11 
LENGTH, 4-6', B-4 
logical, 4-3,' 4-4', B-5 
LOW, 4-11, B-4 
MASK, 3-9, 4-11, 4-13, 

10-6 to 10-9, B-4 

• OFFSET, 4-5', B-4 

PTR, 4-8, 4-9, B-3, B-4 
precedence, 3-1, 4-14, B-4 
record specific, 4-11, 5-9, B-4 
relational, 4-1', 4-2' 

SEG, 3-4, 4-4, 4-5' 4-15, 5-2, 

6-3, 6-5 to 6-7, 11-6, 

11-7, B-4, C-2, D-13, 

D-16, D-19, D-22, D-23 
segment override, 4-8 to 4-10, 
B-3 

SHORT, 4-10, B-3, B-5 
Shift Count, 4-11, 4-12 
SIZE, 4-7i B-4 
synthetic, 4-8' 

THIS, 4-9, B-3, B-4 
TYPE, 4-6; B-4 • • Y+ c 

value returning, 4-4, 4-12, 
4-13, B-4 
WIDTH, 4-12, B-4 
ORG directive, 5-7 7 
"Other M option for invoking the 
assembler, 1-6 

%OUT, 9-3, 9-4, 11-1, B-3, D-22 
Overflow flag, 2-5 

erride operators, 4-8, B-3 


7-5 to 7-8, 8-3, 11-6, 
11-7, B-2, C-l, D-25 
Parity flag, 2-5 
Percent sign, 7-7, 7-8, B-2 
Pointer register, 2-2 to 2-4 
Port addressing, 2-5 
Precedence of operators, 4-14^ 
B-4 

PROC, 5-1, 5-7, 5-8, 6-2, 7-4, 

10- 4, 10-5, 10-12, 10-13, 
B-l 

Procedures, 5-7, 5-8, 6-2, 10-13 

11- 3 

PTR, 4-8i 4-9, 4-15, 5-3, 10-4, 
10-5, 11-2, B-3, B-4, D-25 
PUBLIC, 3-3, 5-8, 6-1, 6-2, 

6-4 to 6-6, 10-4, 10-5, 
10-10, 10-11, 11-8, B-l 
Public combine type, 6-5, 10-10, 
10 - 11 ' 

PURGE, 7-3, B-2 


.RADIX, 5-1, 5-9, B-l 
RECORD, 5-9, B-4, C-l 
Record specific operators, 

4-11'to 4-13, 5-9, B-4 
Relational operators, 4-1, 4-2' 
Register offset addressing, 2-4 
Register operands, 3-10 
Registers, 2-1 to 2-5, 3-9, 3-10 
4-9, 4-10, 5-4, 5-8, 10-3, 
11-1 to 11-3, D-10, 

D-15 to D-17, D-20, D-22, 
D-23, D-26 

base, 2-1 to 2-4, 3-2, 3-4, 

3- 6, 3-9, 3-10, 4-4, 4-5, 

4- 9, 5-4, 5-8, 5-9, 5-11, 
6-1, 6-3, 6-4, 6-6, 6-7, 
10-9, 10-11, 11-2, 11-5, 
C-2, D-19 
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flag, 2-5, 2-6, D-2 to D-4, 
D-10, D-15, D-17, D-18, 

D-21 to D-28 

general, 2-2, 2-3, 3-1, D-16, 
D-17 

index, 2-2 to 2-4, 3-9, 3-10, 

5- 4, 11-3 to 11-5, C-2, 
D-16, D-17, D-28, D-31 

pointer, 2-2 to 2-4 
segment, 2-1 to 2-4, 

Repeat blocks, 7-1, 7-4 
REPT, 7-5, 10-4, 11-3, B-2 
Runtime error messages, 11-9 

§ -- 

.SALL, 9-6, B-3 

SEG, 3-4, 4-4, 4-5, 4-15, 5-2, 

6- 3, 6-5 to 6-7, 11-6, 

11-7, B-4, C-2, D-13, D-16, 
D-19, D-22, D-23 

SEGMENT, 2-1 to 2-4, B-2 
Segment, 2-1 to 2-4, 3-1 to 3-7, 

3- 9, 4-2, 4-4, 4-5, 

4- 8 to 4-10, 4-14, 5-1, 

5- 2, 5-4 to 5-8, 

6- 3 to 6-7, 7-4, 

10-2 to 10-6, 10-10, 

10-11, 10-13, 11-1 to 11-7, 
B-l to B-4, C-l, C-2, D-3, 
D-13, D-T6, D-17, D-19, 
D-24, D-25, D-29 

attributes of, 10-2 to 10-6 
base values, 2-1 
registers, 2-1 to 2-5 
Segment combining, 

align type, 3-3, 6-3, 6-4, 10-1 
class name, 3-3, 6-3, 6-6, 

10-11 

combine type, 3-3, 6-3 to 6-5, 
10-1, C-l 

Segment override operator, (:) 

3-6, 4-5, 4-9^ 4-10, 4-14, 
B-4 

Semicolon, use of in macros, 7-8 


Sign flag, 2-5 
SIZE, 4-7, B-4 
Special macro operators, 

7- 7 to 7-8, B-2 , 

Stack combine type, 6-5, 10-11 
Starting, 

assembler, 1-1 to 1-6, 

I- 8 to 1-10 

CREF, 9-6, 10-1, 12-1 to 12-6, 
12-8, B-3 

invoking method one, 12-2 
invoking method two, 12-2 
Statement line format, 3-5 
action, 3-5 

comments, 3-6, 3-8, 7-8, 9-6, 

II- 3 

directives, 1-1, 1-5, 3-1, 3-5 

3- 9, 4-2, 4-11, 5-1, 5-7, 
5-12, 6-1, 6-3, 8-1 to 8-3 

9- 1, 9-3 to 9-6, 10-11, 

10- 12, 11-3, B-l to B-3 
expressions, 3-1, 3-6, 3-9, 

4- 5, 4-6, 4-14, 5-4, 5-1^ 

8- 2, 9-4, 9-5, 10-12 M 
instructions, 1-1, 1-7, 2-6 

3- 1, 3-3, 3-5, 3-6, 3-9, 

4- 2, 4-8, 4-10, 5-2, 5-7, 

5- 8, 7-1, 10-2, 11-5, D-7, 
D-19, D-22, D-23 

String, 3-8 

STRUCTURE, 2-2, 3-1, 3-6, 3-10, 
3-11, 4-14, 5-4, 5-6, 

5-ll / to 5-13, 10-6 to 10-8 

11- 5, B-4, C-2 

Structure operands, 3-10, 3-11, 
5-13 

SUBTTL, 9-1 to 9-3, B-3 
Switches, 1-5, 9-3, 9-5 
Symbol table, 1-2, 10-6 to 10-9, 

10- 11 to 10-13, 11-8, 

11- 9, 7-2 

Symbols, 1-1, 1-2, 3-4, 3-6, 3-9 
5-4, 6-1, 6-3, 7-6 to 7-8, 
10-2 to 10-6, 10-11, 10-12 

12- 1, 12-4, 12-7, B-l 


.SFCOND, 1-5, 9-5, B-3 
Shift count, 4-ll', 4-12 
SHL, 4-2, 4-15, 10-4, B-4, D-26 
SHORT, 4-8, 4-10; 4-15, B-3, B-5, 
D-ll to D-15, D-18 
SHR, 4-2, 4-15, B-4, D-28 


Synthetic operators, 4-8 


:t suppression directives, 
9-4 to 9-7 
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.TFCOND, 1-5, 9-5, 9-6, B-3 
THIS, 4-9', B-3, B-4 
TITLE, 9-1 to 9-3, B-3 
TYPE, 4-6, B-3 
.TYPE, 4-7, B-3 to B-5 
Type, 3-6 

Type attribute, 3-7, 4-9 
Type operator, 4-6, 4-7 


Value returning operators, 4-4, 
B-4 

Variables, 1-2, 2-2, 3-4, 

3- 6 to 3-10, 4-1, 4-2, 

4- 5, 4-8, 4-9, 5-9, 5-12, 
6-4, 6-5, 7-3, 9-7, 10-4 


WIDTH, 4-1* to 4-14, B-4 

Width shift, 10-8 

Word align type, 6-4, 10-10 


/X switch, 9-5 
.XALL, 7-8, 9-6, B-3 
.XCREF, 9-6, 9-7, B-3 
.XLIST, 9-4, 9-5, B-3 


Zero flag, 2-5 


4 “II 
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